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:

HeaderHTTP Status
Content-Type: application/jsonHMAC SHA256 signature of the request
X-Ownright-Client-IdYour unique API client ID
X-Ownright-API-KeyYour long-lived API key used for authentication
X-Ownright-Organization-IdA 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.