> ## Documentation Index
> Fetch the complete documentation index at: https://dev.ownright.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecting

> General details on how to connect to the Partner API

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:

```bash Example request theme={null}
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 } }"}'
```

<Tip>
  Use tools like [Postman](https://www.postman.com/),
  [Insomnia](https://insomnia.rest/), or
  [GraphiQL](https://github.com/graphql/graphiql) for easier request building
  and testing.
</Tip>

## 🔒 Need Help?

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