Get an Organization Token

Learn how to retrieve an organization token using the API.

Because most API calls are scoped to a specific organization, you also need an organization token to send API requests.

To get an organization token:

  1. Create a personal API token.

  2. Send a request to retrieve all organizations you belong to. Replace YOUR-PERSONAL-API-TOKEN with your token.

    curl -X GET "" \
        -H "Accept: application/vnd.cobalt.v2+json" \
        -H "Authorization: Bearer YOUR-PERSONAL-API-TOKEN" \
        | jq .
  3. From the output, save the token value for the desired organization. In our API documentation, you’ll see this as YOUR-V2-ORGANIZATION-TOKEN.

    Example response:

      "data": [
          "resource": {
            "id": "some_id",
            "name": "Name of your organization",
            "token": "YOUR-V2-ORGANIZATION-TOKEN"
          "links": {
            "ui": {
              "url": ""
      "pagination": {
        "next_page": "/orgs?cursor=a1b2c3d4",
        "prev_page": "/orgs?cursor=4d3c2b1a"

Include the organization token in the X-Org-Token header of your requests.


For more information, see our API reference documentation on the organizations endpoint.

Was this page helpful?

Yes No Create an Issue

Last modified September.09.2023