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

# Get started with the API

> Create an Application, get a token, and make your first call in 3 minutes.

The ApyConnect API lets you build on top of your workspace: contacts, conversations, multichannel
messaging, campaigns, analytics, and webhooks. Base URL: `https://api.apyconnect.io`.

<CardGroup cols={2}>
  <Card title="OpenAPI spec" icon="code" href="https://api.apyconnect.io/v1/openapi.json">
    The full 3.1 spec (same one that powers the Reference tab).
  </Card>

  <Card title="Download Postman" icon="download" href="/apyconnect.postman_collection.json">
    Collection ready to import into Postman/Insomnia.
  </Card>
</CardGroup>

## 1. Create an Application

Under **Settings → API**, create an Application. You'll get a `client_id` and a `client_secret`
(the secret is shown **only once**). Pick the **scopes** it will need.

## 2. Get an access token

Tokens are short-lived **opaque Bearer** tokens (\~1 h), issued with the `client_credentials` grant:

```bash theme={null}
curl -X POST https://api.apyconnect.io/oauth/token \
  -u "$CLIENT_ID:$CLIENT_SECRET" \
  -d grant_type=client_credentials
```

```json theme={null}
{ "access_token": "at_live_…", "token_type": "Bearer", "expires_in": 3600 }
```

<Note>**Scopes aren't requested here** — the token inherits its Application's scopes. Check them at `GET /v1/me`.</Note>

## 3. Make your first call

```bash theme={null}
curl https://api.apyconnect.io/v1/contacts \
  -H "Authorization: Bearer $TOKEN"
```

Every response is wrapped and carries a `request_id` for support:

```json theme={null}
{
  "object": "list",
  "data": [ { "object": "contact", "id": "per_…", "name": "Ada Lovelace", "email": "ada@example.com" } ],
  "pagination": { "next_cursor": "…", "has_more": true, "limit": 25 },
  "meta": { "request_id": "req_…" }
}
```

## Next

* [Authentication & scopes](/es/api/autenticacion)
* [Pagination & filters](/es/api/paginacion)
* [Errors & rate limits](/es/api/errores)
* [Webhooks](/es/api/webhooks)