Open API v1

Getting started

Create a scoped API key, then make your first request.

1. Create an API key

1. Open the TaggoAI dashboard.
2. Go to Settings → Developer.
3. Under Open API keys, click Create key.
4. Give it a name, pick Live or Test, and select scopes.
5. Copy the secret immediately. TaggoAI only shows it once.

The secret looks like tg_live_... or tg_test_....

2. Base URL and environments

Test keys are scoped the same way as live keys. They still operate on the workspace that created them.

Do not put an API key in a browser, mobile app, or any other client you do not control.

3. First request

curl https://api.taggoai.com/open/v1/contacts?limit=1 \
  -H "Authorization: Bearer tg_live_YOUR_KEY"

A successful list response looks like:

{
  "object": "list",
  "data": [],
  "has_more": false,
  "next_cursor": null
}

4. Next steps

• Read Authentication for scopes and rotation.
• Read Conventions for pagination, errors, and rate limits.
• Use a guide: contacts, tickets, messages, or webhooks.