Chift connector-picker

Chift hosts the connector picker. You build nothing: your end-user picks their software on a Chift page, then connects it on the connector page.

Connector picker on the Chift-hosted connector-picker — Chift connector-picker: your end-user picks their software on a Chift-hosted page.

Create the consumer

Create one consumer per end-user. Store the returned consumerid on your end-user record. You reuse it for every connection that end-user makes.

curl -X POST https://api.chift.eu/consumers \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Your end-user's company name",
    "internal_reference": "your-internal-end-user-id",
    "email": "contact@your-end-user.example",
    "redirect_url": "https://yourapp.example/integrations/callback"
  }'

Field	Required	Notes
`name`	Yes	Shown in your Chift platform and used in automated emails.
`email`	No	Used for activation reminders and emailing the local agent installer.
`internal_reference`	No	Your own ID for this end-user. Makes reconciliation much easier later.
`redirect_url`	No	Where the end-user lands after activation. Can also be set once for the whole account. See Activation links and redirects.

Already have a consumerid for this end-user? Skip this step.

API reference: Create new consumer ↗

Create the connection

Create the connection without integrationid:

curl -X POST https://api.chift.eu/consumers/{consumerid}/connections \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "country": "BE",
    "apis": ["Accounting"],
    "redirect": true
  }'

Field	Required	Notes
`country`	No	ISO 3166-1 alpha-2. Shows only the connectors that support this country.
`apis`	No	Shows only the connectors of these Unified APIs.
`redirect`	No	Default `false`. `true` sends the end-user to the consumer’s `redirect_url` after activation. See Activation links and redirects.

The call returns a single field: url.

A consumer can have only one connection per connector. If the connection already exists, for example to refresh expired credentials, update it instead. See Update an existing connection ↗.

API reference: Add new connection ↗

Send the end-user to the link

Redirect your end-user to the returned url, or email it to them.

The link is secured by a token that expires after 30 minutes. Generate it when the end-user is about to click it, not in advance.

Your end-user picks their software, then connects it. What they see depends on the connector: an OAuth2 consent screen, a credentials form, or instructions to install the local agent. Some connectors then ask follow-up questions, such as which accounting folder or which POS location. See Post-connections.

Check the connection

When the end-user finishes, reload the consumer’s connections and confirm the connection is active. Then you can call the Unified API for that consumer.

curl https://api.chift.eu/consumers/{consumerid}/connections \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Do not rely on the redirect alone. An end-user who abandons the flow never triggers it. See Monitoring & updating connections for the webhook, polling, and redirect-parameter options.API reference: Get connections ↗

Getting started

Building path

Core Concepts

Chift connector-picker