Workspace

Create an API key

POST/v1/keys

Creates a key. The secret is shown once. Pass inboxes to limit it to the agent surface on those inboxes.

Parameters

Body parameters2

name?string

A label for the key.

inboxes?string[]

Limit the key to these inboxes.

Returns

201A JSON object describing the result.Errors return error and message; see Errors and limits.

POSTCreate an API key

curl -X POST "https://api.getensue.com/v1/keys" \
  -H "authorization: Bearer $ENSUE_API_KEY"

const res = await fetch("https://api.getensue.com/v1/keys", {
  method: "POST",
  headers: {
    authorization: `Bearer ${process.env.ENSUE_API_KEY}`,
  },
});
console.log(await res.json());

import os, requests

res = requests.post(
    "https://api.getensue.com/v1/keys",
    headers={"authorization": f"Bearer {os.environ['ENSUE_API_KEY']}"},
)
print(res.json())

201Response

Returns a JSON object describing the result.