Tokens are required to access the integrator.io API. Account owners and administrators can use the integrator.io API to perform add/edit/delete operations on any resource in their account. Only these two roles can view the API tokens page.
Contents
Generate an API token
An API token provides authentication to integrator.io from the third-party endpoint, so that you can access the resources that you specify. An account owner or administrator can create an API token that applies to an account or an Integration App, as follows:
- Turn on Developer mode to be able to view and modify the tokens.
- Create the token in one of the following ways:
- Common to your integrator.io account – Open API tokens from the Resources menu. Click + Create API token at the top right.
- Specific to an Integration App – In the Integration App’s dashboard, open the Admin tab, click the API tokens setting. Click + Create API token at the top right.
Enter the General settings and Token permissions, and save the API token, then copy the token for use in the calling app.
Create API token – General settings
Name (required): Provide a meaningful name to distinguish it from other tokens in the list.
Description (optional): Enter any identifying characteristics of this API token item.
Auto purge token (required): Select the time after which the token should be automatically purged from the system.
Note: If you are unable to generate long-lived API tokens (tokens with expiration limits beyond one hour), you must add an API Management license to your account. This license allows you to create tokens that are valid for longer than one hour. API Management is included in Enterprise plans and is available for purchase in Standard, Professional, and Premium plans.
Create API token – Token permissions
Scope (required): Set the access permissions for your token:
- Full access – tokens provisioned at the account level have unrestricted permissions to your integrator.io account. No further scopes need to be selected.
- Custom – tokens can be created with only minimal permissions to specific resources in your integrator.io account, and they can only be used to invoke very specific integrator.io APIs. Multiple selections are allowed for the custom scopes chosen below.
Connections (enabled for custom scopes, optional): Select the connections that this token will be able to access.
Exports (enabled for custom scopes, optional): Select the exports that this token will be able to access.
Imports (enabled for custom scopes, optional): Select the imports that this token will be able to access.
My APIs (enabled for custom scopes, optional): Select the My APIs that this token will be able to access.
Save or Save & close (required): Click to save your new token.
Manage and retrieve the API token
You can manage your tokens in the API tokens page or the Integration App’s Admin tab; several options are available under Action:
- Edit API token
- View audit log
- Revoke API token
- Generate new API token
To copy the token, click Show token and select the copy button ( 
).
Why am I getting token email notifications?
If you're the account owner or administrator, you'll receive an email alert notification every time a token is created, accessed, modified, or if a token is viewed in plain text (to expose the actual token) to inform you of the activity. This is a security measure, to make you aware of any activity involving these tokens.
If you suspect that your account password has been compromised, click the user avatar icon > My account. In the My account page, click the pencil icon next to Password to specify a new password.
Note that the actual token is never revealed in the email or via the user interface, unless the user with access permissions actively clicks to view the token.
Comments
4 comments
Hi,
Even when we select the Auto purge token as Never, the token is not showing in IO.
Sorry for the delay, UPPAbaby Admin. I tried to reproduce this scenario, but I'm using the latest build, which would be a newer version than what you had available in your initial thread.
No matter what permissions I set for the token, I see the familiar "Show token" option. Do you see anything in the "Token" column now in the API tokens page?
Hi,
I am an account admin and have enabled Developer Mode. However, I don't see My APIs option in the Resource menu so am unable to generate the tokens. Please advise.
Hi, Tam Nguyen. This article applies to Resources > API tokens.
Only the account owner can see Resources > My APIs.
Please sign in to leave a comment.