Skip to main content
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.