Stitch Documentation
has moved!

Please update your bookmarks to

If you're not automatically redirected after 5 seconds, click here.

Authenticating with the Import API

Authentication with the Import API is done with a single API access token and your client ID.

Generating an API Access Token

You can generate an API access token by logging into your Stitch account and adding an Import API integration:

  1. From the Stitch Dashboard page, click the Add an Integration button.
  2. Click the Stitch Import API icon.
  3. Enter a name for the integration. This is the name that will display on dashboard page; it’ll also be used to create the schema in your data warehouse.

    For example, the name “Stitch CRM” would create a schema called stitch_crm in the data warehouse.
  4. Click the Save and Generate Token button.

This token has write access to your Stitch account. Do not distribute it to untrusted third parties.

You can authenticate to the API by providing your API access token in the Authorization header of your request. 

curl -X POST \
	-H 'Content-Type: application/json' \
	-H 'Authorization: Bearer < access-token >' \
	-d @filename

Note that you can push more than one table using the same API access token. Think of it this way: one schema for each API access token. All tables pushed using the same API access token will be housed in the same schema in your data warehouse.

Locating Your Client ID

Look at your URL while on the Dashboard page to find your client ID. It’s the four-digit number between client and pipeline:

Your client ID is included in the request body, in the client_id field. See the Upsert Method section of the Import API Methods article for more info on this and the other required values.


Was this article helpful?
0 out of 0 found this helpful


Questions or suggestions? If something in our documentation is unclear, let us know in the comments!