Skip to main content
Reference for the activation link returned by connection creation, and for where your end-user lands afterwards. Creating or updating a connection returns one field, url. Properties worth knowing:
  • Secured by a token that expires 30 minutes after generation.
  • Single purpose: it activates one connection for one consumer.
  • Safe to email, but generate it close to when the user will click it. If it expires, PATCH the connection to get a fresh one.

​
The two parameters

Redirect behaviour is controlled by two settings that are easy to confuse: redirect_url can be set per consumer (at creation or update) or once for the whole account — see Configure account. When both are set, the consumer-level value wins.
redirect is ignored when you pass integrationid. With a connector already chosen, Chift always redirects to redirect_url on success. There is no marketplace page left to return to.

​
On connection creation

​
On connection update

​
URL parameters on return

When a redirect happens, Chift can append query parameters describing the result:
This must be switched on for your account — see Configure account. Until it is, your callback receives a bare redirect_url with no parameters.
These parameters are convenient but not a reliable completion signal: a user who abandons the flow never returns, and a browser can be closed mid-redirect. Pair them with a webhook or a periodic check — see Monitoring & updating connections.