Account

Who the key is

GET /v1/c/{slug}/me · Scopes: any key

The company, the key's name, whether it is live or test, its scopes and the rate limit. A good first call for an integration.

Path parameters

Field	Notes
`slug`	The company's identifier in DoneTalk (the key's own).

Request example

curl -X GET "https://api.donetalk.com/v1/c/demo/me" \
  -H "Authorization: Bearer $DONETALK_KEY"

Response 200

{
  "memberId": "01a1b2c3-d4e5-7f60-8a9b-0c1d2e3f4a5b",
  "role": "integration",
  "permissions": [
    "api.use",
    "campaigns.read",
    "campaigns.start",
    "campaigns.write",
    "contacts.read",
    "contacts.write"
  ],
  "company": {
    "slug": "captei",
    "name": "Captei"
  },
  "key": {
    "name": "ERP Captei",
    "prefix": "dt_live_7Hq2mV0c",
    "environment": "live",
    "scopes": [
      "campaigns:read",
      "campaigns:write",
      "campaigns:send",
      "contacts:write"
    ],
    "legacy": false,
    "skipApproval": false,
    "expiresAt": null
  },
  "rateLimit": {
    "limit": 600,
    "windowSeconds": 60
  }
}

Possible errors

401 unauthorized
403 insufficient_scope
422 validation_failed
429 rate_limited

This page as Markdown