Audience API & API keys
The Audience API lets organizers and promoters connect other tools to Community: create a scoped API key, then push, search and update contacts and list members over HTTPS.
What you get
Scopes contacts:read, contacts:write and lists:write, with presets
Bulk upsert contacts with an optional list and your own external ids
Search and update contacts; add or remove list members
300 reads and 60 writes per minute per key; every write is logged
Keys shown once, with optional expiry, rotate and revoke
Audience API & API keys in detail
The Audience API lets another tool add people to your Trybe audience automatically: a form on your website, a partner's system or a lead tool. In Settings → API keys you create one key per tool with the scopes it needs (contacts:read, contacts:write, lists:write, or the presets Push contacts in, Sync contacts and lists, Everything, Read only), an optional expiry, and you copy it once.
Calls go to https://api.trybe.fm/public/v1/audience/ with Authorization: Bearer trybe_sk_… and cover POST /contacts (bulk upsert, optionally into a list, with external ids per provider so the same person is recognized next time), GET /contacts/search, GET and PATCH /contacts/{id}, and POST or DELETE /lists/{slug}/members. Limits are 300 reads and 60 writes per minute per key; every write is audit-logged and an activity feed shows what each key did. Contacts created this way show API as their source. Consent remains yours: only push people who agreed to hear from you. Today the API covers your audience: contacts and the lists they belong to.
How it works
Create a key
In Settings → API keys, pick scopes or a preset and copy the key once.
Push contacts
Call POST /contacts with an email or phone, optional properties, an external id and a list.
Keep it in sync
Search, read and update contacts, or manage list members, within the rate limits.
Watch the activity
The key's activity feed and audit log show every write; rotate or revoke when needed.
Questions organizers ask
Does Trybe have a public API?
Yes, an Audience API for contacts and lists. With an API key you can bulk upsert contacts, search and update them, and add or remove list members. Events, tickets and orders are not part of it today.
How do I get an API key?
Go to Settings → API keys, name the key after the tool that will use it, pick the scopes or a preset, optionally set an expiry, and copy the key: it is shown once. You can rotate or revoke it at any time.
What are the rate limits?
300 reads and 60 writes per minute per key. Bulk upserts let you send many contacts in one write.
Can I keep another tool in sync with my Trybe audience?
Yes. Read contacts and lists with a read scope, push new people and update existing ones with write scopes, and pass your own external id so the same person stays matched across tools. Each key is limited to 300 reads and 60 writes per minute.
Can I connect my website's sign-up form?
Yes. Have your form call POST /contacts with contacts:write (and lists:write to drop people into a list). The new contacts appear in Community with API as their source and can trigger the Added to a list automation.
How does Trybe avoid duplicates from the API?
Contacts are unique per email within your organization, and you can send your own external id with a provider name so Trybe recognizes the same person on the next call. Upserts update the existing contact instead of creating a new one.
Related features
Community (CRM)
Everyone who bought, joined or subscribed, in one list you own, with orders, spend and consent
Lists & audience templates
Lists you control, fed by imports, sign-ups, pre-sales and automations, plus ready-made segment templates
Automations
Flows that run on their own when fans follow, buy, abandon a cart or have an event coming up