Skip to content

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.

Available on EnterpriseUpdated 2 min read
On this page
  1. Create a token
  2. Use it
  3. Who a token acts as
  4. Revoke a token

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

  1. Open Settings, then API access.
  2. Under API tokens, select Create token.
  3. Name it after the tool that will use it, for example "Reporting dashboard".
  4. Under What it may do, tick only the permissions the tool needs (see the table below).
  5. Choose the brands it may see, or All brands I can reach.
  6. Choose when it Expires: in 7 days, 30 days, 90 days, 6 months, a year, or never.
  7. 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

  1. Open Settings, then API access.
  2. 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?

Ask a question