Skip to content
iResendlyDocs

API keys

Create, list and revoke API keys.

3 endpoints

Create an API key

POST/api-keys

The full key is in this response only; store it straight away. Plan limits: 5, 50 or 100 keys.

Body
  • namestringrequired

    A name to recognise it by.

  • permissionstring

    full_access (default) or sending_access, which can only send email.

  • domain_idsstring[]

    Up to 100 domain ids a sending_access key may send from (domain_id for one also works).

POST/api-keys
curl -X POST 'https://api.iresendly.com/api-keys' \
  -H 'Authorization: Bearer irs_xxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Production",
  "permission": "sending_access",
  "domain_ids": [
    "d91cd9bd-1176-453e-8fc1-35364d380206"
  ]
}'
Response
{
  "id": "6719f2c4a8b3d5e1f0a2b3c4",
  "token": "irs_c1tpEyD8NKFusih9vKVQknRAQfmFcWCvaB3nK0"
}

List API keys

GET/api-keys

Never includes the key itself, only a preview.

GET/api-keys
curl -X GET 'https://api.iresendly.com/api-keys' \
  -H 'Authorization: Bearer irs_xxxxxxxxx'
Response
{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "id": "6719f2c4a8b3d5e1f0a2b3c4",
      "name": "Production",
      "token_preview": "irs_c1tpEyD8…",
      "permission": "sending_access",
      "domain_ids": [
        "d91cd9bd-1176-453e-8fc1-35364d380206"
      ],
      "created_at": "2026-11-07T10:00:00.000Z",
      "last_used_at": "2026-11-07T12:30:00.000Z"
    }
  ]
}

Revoke an API key

DELETE/api-keys/{id}

Revokes the key immediately. A key can't revoke itself.

Path parameters
  • idstringrequired

    The key id.

DELETE/api-keys/{id}
curl -X DELETE 'https://api.iresendly.com/api-keys/{id}' \
  -H 'Authorization: Bearer irs_xxxxxxxxx'
Response
{
  "object": "api_key",
  "id": "6719f2c4a8b3d5e1f0a2b3c4",
  "deleted": true
}
Still stuck? Write to us and we'll reply by email.Contact ussupport@iresendly.com