---
title: "Create a new org-level ingestion token"
method: POST
path: "/api/{org_id}/ingestion-tokens"
tags: ["Organizations"]
---

# Create a new org-level ingestion token

`POST /api/{org_id}/ingestion-tokens`

## Request

- Base URL: `https://api.openobserve.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openobserve.ai/api/{org_id}/ingestion-tokens`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/openobserve/apis/openobserve-api-http/docs/api/:org_id/ingestion-tokens/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new named ingestion token at the org level. Requires Admin or Root role. The full token value is returned once.

## Path parameters

- `org_id` string, required

## Request body

- object
  - `description` string, nullable
  - `name` string, required
  - `splunk_token` boolean: Also mint a Splunk HEC token for this credential.

## Response `200`

Success

- object
  - `data` OrgIngestionToken, required
    - `created_at` integer, required
    - `created_by` string, required
    - `description` string, required
    - `enabled` boolean, required
    - `is_default` boolean, required
    - `name` string, required
    - `splunk_token` string, nullable
    - `token` string, required

## Other responses

- `400`: Bad Request
- `403`: Forbidden

---

[API](https://skmtc.dev/openobserve/apis/openobserve-api-http.md) - [All operations](https://skmtc.dev/openobserve/apis/openobserve-api-http/llms.txt) - [OpenAPI document](https://skmtc.dev/openobserve/apis/openobserve-api-http/revisions/0529b8a10252?raw)