Skip to main content
POST
https://prod-contactswing-fastapi-962560522883.us-central1.run.app
/
v2
/
_api_keys
Create API Key
curl --request POST \
  --url https://prod-contactswing-fastapi-962560522883.us-central1.run.app/v2/_api_keys \
  --header 'Authorization: <authorization>'

​
Authorizations

​
Authorization
string
required
Enter your ContactSwing JWT Bearer token.

​
Request Body

JSON: ApiKeyRequest (see OpenAPI spec)
​
name
string
required
API key display name. Example: Production SMS Key
​
description
string
Key purpose/description.
​
permissions
array
Array of allowed permissions/scopes.
​
expires_at
string
ISO 8601 expiration date (optional).

​
Complete Example

{
  "name": "My Production API Key",
  "description": "SMS and Webhook actions only",
  "permissions": ["actions:read", "actions:write", "sms:send"],
  "expires_at": "2026-12-31T23:59:59Z"
}