Skip to main content
POST
Create an integration API key for explicitly granted projects. The generated key is returned once, without a receipt copy.
Create an integration API key for explicitly granted projects. The generated key is returned once, without a receipt copy. Requires a scoped personal key, an explicit granted project_id, and integration_keys.write. Current role and credential grants remain enforced. See Agent messaging and project operations for authorization and recovery.

Authorizations

Authorization
string
header
required

Integration key for backend workloads, or a scoped personal key (sr_user_) for account discovery and supported project operations. MCP accepts only personal keys.

Headers

X-Sendrealm-Project-Id
string<uuid>
required

Body

application/json
name
string
required

Display name.

Required string length: 1 - 120
permissions
enum<string>[]
required

Explicit integration-key permissions.

Required array length: 1 - 6 elements
Available options:
*,
email.send,
push.send,
events.ingest,
resources.read,
resources.write
key_type
enum<string>

Default project. Team keys require current team-level key management access.

Available options:
project,
team
project_scope
enum<string>

Project access scope. Personal-key callers can select only explicitly granted projects; all_projects requires a dashboard session.

Available options:
all_projects,
selected_projects
project_ids
string<uuid>[]

Explicit granted projects for a team key.

Maximum array length: 500

Owned resource UUID from the matching list operation.

Required string length: 1 - 36

Response

Authorized result, preparation, or durable execution receipt.

status
integer
required
data
object
required