Skip to main content

Personal access tokens

Create a personal access token for scripts and tools, choose what it can access, and rename, revoke, or delete it.

Written by Leo

A personal access token (PAT) lets a script or tool use the Tape API as you. You choose which workspaces and apps it can reach and what it's allowed to do.

Note:

  • The token appears only once. Copy it before you close the dialog. You can't see it again.

  • A token can't do more than you can. You can only give it capabilities you have yourself.

  • Revoking stops it immediately. Scripts and tools that use the token stop working at once.

Who can use personal access tokens?

  • Organization owners, Organization admins, and Members can open Developer in Settings. Guests don't see it. Learn more about organization roles →

  • Each token belongs to you and is used on your behalf. Records it creates or changes show you as the author, and emails it sends go out in your name. To show a tool under its own name, create a separate user for it and create the token from that account.

Create a personal access token

To create a token:

  1. Select your organization name at the top of the sidebar, then select Settings. You can also select your profile picture, then Preferences.

  2. Under Features, select Developer.

  3. Under Personal access tokens (PATs), select New token.

  4. Enter a Token name that says what the token is for.

  5. Under Content access, choose the workspaces and apps the token can reach. Select All for everything, including workspaces and apps you add later. A workspace you choose includes all its apps, also apps added later. An app you choose doesn't include its workspace.

  6. Under Capabilities, choose what the token may do, grouped by Organization, Workspaces, Apps, Records, Automations, and Advanced. Select All for every capability, including ones added later.

  7. Select Create token.

  8. Select Copy and close to copy your token and close the dialog.

Opening Preferences from the profile picture menu, selecting Developer and New token, entering Monthly sales report, choosing the CRM workspace under Content access and Read records under Capabilities, and pointing at Create token

New personal access token dialog with the Token name Monthly sales report, All selected under Content access and Capabilities, and Create token

Paste the token into your script or tool right away. Tape shows it only once. Learn more about the Tape API →

Tip: Create one token per script or tool, with a name you'll recognize, and give it only the access it needs. If a token may have leaked, revoke it first and investigate afterwards.

See your tokens

The Developer page lists your tokens with their Name, Content access, Capabilities, Status, Created, and Last used. Use Search tokens… to find one, or click the Filter icon to show only Active or Revoked tokens.

A token's status is Active until you revoke it, then Revoked. The list shows only the first and last few characters of each token, so you can tell them apart.

Rename, revoke, or delete a token

Click the Actions icon in the row of the token.

  • Rename: only for active tokens. Opens Rename access token. Enter a new Token name and select Save.

  • Revoke: stops the token for good. Confirm with Revoke this access token.

  • Delete: removes a revoked token from your list. Confirm with Delete this access token. Delete only works for tokens you revoked first, and can't be undone.

Note: Webhooks keep running after you revoke a token. If a script created webhooks with the token, they keep sending messages. Delete them in each app. Learn more about app webhooks →

Personal access token limits

  • You can have up to 20 active tokens at a time. Revoke one to create another.

  • A token can reach up to 50 workspaces and 50 apps that you choose. For more, select All.

  • A token name can have up to 500 characters.

Your old API key

If you still have a personal API key from before, it's listed as API Key. Select Copy API key to copy it, or Delete to remove it. Confirm with Delete this API key. A deleted key stops working immediately and can't be restored. Use a personal access token from now on.

Token errors

  • "The token could not be created.", "The token could not be renamed.", "The token could not be revoked.", and "The token could not be deleted." mean the action failed. Try again.

  • If a script gets an access error, check that the token's Content access and Capabilities cover what it does, and that the token is Active.

FAQs

Can I see a token again after I created it?

No, the token appears only once, when you create it. Create a new token if you lost it, and revoke the old one.

Can I limit a token to one app?

Yes, under Content access, choose only the workspace or app the token should reach.

Does a token expire?

No, a token has no expiration date. It stays Active until you revoke it.

Can I change what a token can access later?

No, you can only rename a token. To change its Content access or Capabilities, create a new token and revoke the old one.

Why can't I delete an active token?

Because Delete is only offered for revoked tokens. Revoke the token first.

Are you a developer using the Tape API?

Yes, find the full documentation in the Tape developer docs →.

Still have more questions? Find answers and get help from community experts in the Tape community →.

Did this answer your question?