# Echo developer guide

> The Echo API lets your own systems manage a workspace's subscribers, groups, segments, fields, campaigns, automations and webhooks. Webhooks tell your systems when something happens in Echo.

The Echo API lets your own systems manage a workspace's subscribers, groups, segments, fields, campaigns, automations and webhooks. Webhooks tell your systems when something happens in Echo.

This guide is for developers. The customer side (creating tokens and webhooks in the app) is in the [Integrations](https://docs.uptools.io/echo/user-guide/integrations/) chapter of the [user guide](https://docs.uptools.io/echo/user-guide/).

**Contents**

1. [Quickstart](https://docs.uptools.io/echo/developer-guide/quickstart/): base URL, first request, request and response format, pagination, idempotency
2. [Authentication](https://docs.uptools.io/echo/developer-guide/authentication/): API tokens, access levels, allowed IP addresses
3. [Subscribers](https://docs.uptools.io/echo/developer-guide/subscribers/): list, count, add or update, read, change, unsubscribe, delete, forget, activity
4. [Groups, segments and fields](https://docs.uptools.io/echo/developer-guide/groups-segments-fields/)
5. [Import through the API](https://docs.uptools.io/echo/developer-guide/import/): bulk import into a group and its progress
6. [Campaigns](https://docs.uptools.io/echo/developer-guide/campaigns/): drafts with Custom HTML content, test email, scheduling, results
7. [Automations](https://docs.uptools.io/echo/developer-guide/automations/): workflows, statistics, runs, activating, pausing, adding subscribers
8. [Webhooks](https://docs.uptools.io/echo/developer-guide/webhooks/): events, payloads, signature check, retries, target rules
9. [Batch requests](https://docs.uptools.io/echo/developer-guide/batch-requests/): up to 50 requests in one call
10. [Errors and limits](https://docs.uptools.io/echo/developer-guide/errors-and-limits/): error format, codes, rate limits, size limits

**The machine-readable reference**

The full OpenAPI 3.1 document is public, no token needed:

```bash
curl https://echo.uptools.io/public/v1/openapi.yaml
```

Every example in this guide was run against a working Echo installation with fictional demo data. IDs, addresses and times in the answers are examples: yours will differ.