Create and manage API tokens
Create a token with only the permissions and brands a tool needs, keep it safe, and revoke it at once when it is no longer needed.
An API token lets one of your tools use the Trabbly Social API. Tokens are part of the Enterprise plan. Only owners and admins can create and revoke them; for example Harry Bennett (owner) or Charlotte (admin).
Create a token
- Open Settings, then API access.
- Under API tokens, select Create token.
- Name it after the tool that will use it, for example "Reporting dashboard".
- Under What it may do, tick only the permissions the tool needs (see the table below).
- Choose the brands it may see, or All brands I can reach.
- Choose when it Expires: in 7 days, 30 days, 90 days, 6 months, a year, or never.
- Select Create token.
| Permission | Lets the token |
|---|---|
read:brands |
List brands and their connected social accounts |
read:posts |
Read posts, each platform version, its status and approvals |
write:posts |
Create drafts and send them for review |
read:media |
List and read media in brand libraries |
write:media |
Upload images and videos |
read:analytics |
Read analytics summaries |
The token (it starts with trb_live_) is shown only once. Copy it into your tool's secret settings straight away. Trabbly keeps only a scrambled copy, so it can't show it again. The dialog also shows a command to try it.
Use it
Send the token with every request in the Authorization: Bearer header. Tokens work only on the API; they aren't accepted by the app itself, and signing in to the app doesn't open the API.
Who a token acts as
A token acts for the person who created it:
- It can only do what its permissions allow, and never more than its creator can do now.
- If its creator leaves the organisation or stops being an owner or admin, it stops working.
- Anything it creates is recorded under its creator's name in the activity log and approvals.
Revoke a token
- Open Settings, then API access.
- Select Revoke on the token, then Revoke token.
A revoked or expired token stops at once. Each token shows when it was last used.
An organisation can have up to 50 active tokens. Creating and revoking tokens is recorded in the activity log.
Was this article helpful?
Related articles
- The Trabbly Social APIWhat the public API can do (read brands, posts, media and analytics, upload media, create drafts), who can use it and where the full reference is.
- Receive events with webhooksHave Trabbly send your server a signed message when a post is published, publishing fails, or a reviewer decides.