> ## Documentation Index
> Fetch the complete documentation index at: https://docs.contactswing.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create API Key

> Create a new API key via the ContactSwing API.

### 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

```json theme={null}
{
  "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"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.