Customers

Every customer in your app has their own set of integrations: credentials for external apps, settings, etc.
Depending on how your app is organized, a "customer" in integration.app could be a single user, a team, or an organization.

Customers and Customer Instances

Integration.app keeps track of your customers who use integrations and lets you navigate and manage their data.

Each customer has an id, optional name, and fields that contain any information you need to use in your integration logic.
For example, you can store a user's API Token in fields.apiToken and use it to make requests to your API from within integrations.

Customer Fields

You can configure the list of fields on the Settings page.

You can set user fields in two ways:

  1. By adding a fields claim to the Authentication Token. Whenever integration.app sees a new set of fields in the token, it saves them to be used going forward.
  2. By updating users using PATCH /users or PUT /users methods of the REST API

You can see the current state of user fields by finding the user on the Users page and clicking on it.

Test Customer

When you configure or run integrations in Console, your Test User is used.
You can configure the test user's ID, Name, and Fields on the Testing tab of the Settings page.

Access token generated for the test user is available at the bottom of the page—copy it to use in your test code.