Connecting

Before you start sending queries and mutations, you need to know where to send requests and what headers to include. This page covers the basics of making a successful connection to the Ownright Partner API.

🔗 API endpoint

All GraphQL requests are sent to a single HTTPS endpoint:

POST https://api.ownright.com/partners/graphql

🧾 Required headers

Every request to the Partner API must include the following headers:

Header	HTTP Status
`Content-Type: application/json`	HMAC SHA256 signature of the request
`X-Ownright-Client-Id`	Your unique API client ID
`X-Ownright-API-Key`	Your long-lived API key used for authentication
`X-Ownright-Organization-Id`	A constant identifier for the Ownright platform

These headers are used to authenticate your requests and route them correctly.

📦 Example Request

Here’s an example of a basic GraphQL request using curl:

Example request

curl -X POST https://api.ownright.com/partners/graphql \
  -H "Content-Type: application/json" \
  -H "X-Ownright-Client-Id: your-client-id" \
  -H "X-Ownright-API-Key: your-api-key" \
  -H "X-Ownright-Organization-Id: ownright-prod-org" \
  -d '{"query": "query { referral(id: "gid://ownright/Referral/1") { id } }"}'

Use tools like Postman, Insomnia, or GraphiQL for easier request building and testing.

🔒 Need Help?

If you haven’t received your client ID or API key yet, read the Authentication documentation.

Getting Started

Core Concepts

Guides

API Reference

Queries

Mutations

Members

Webhooks

🔗 API endpoint

🧾 Required headers

📦 Example Request

🔒 Need Help?

​🔗 API endpoint

​🧾 Required headers

​📦 Example Request

​🔒 Need Help?

🔗 API endpoint

🧾 Required headers

📦 Example Request

🔒 Need Help?