Skip to main content
POST

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password. Use your client_id as the username and your secret as the password value.

Body

application/json

The user to scope the token to, and optionally its lifetime and phone number.

​
external_user_id
string
required

Your unique identifier for the user.

Maximum string length: 256
Example:

"123abc"

​
expires_in
integer
default:86400

Seconds until the token expires. Defaults to 1 day; maximum 30 days.

Required range: 60 <= x <= 2592000
Example:

3600

​
phone_number
string

User's phone number in E.164 format. Must be a valid US or Canadian phone number. Required for the Supernova MCP to create sign-in links (see Knot Zero links).

Example:

"+12025550123"

Response

Successful request.

​
token
string

The Supernova MCP token. Treat it as a secret.

Example:

"sn_mcp_wyLZTDc3_HzXo5lcRkkbZpnmFfg5DU63nHnUsyPQbi0"

​
expires_at
string<date-time>

When the token expires, in ISO 8601 UTC.

Example:

"2026-10-21T15:30:00Z"