BackendHTTP APIConnect

Create a reconnect session

Requires an API key with the environment:connect_sessions:write scope. Learn more about API key scopes.

POST
/connect/sessions/reconnect

Create a new connect session to reconnect to a specific integration. The token is used like a standard connect session. Only connections created with a connect session are compatible with this endpoint. Use this method when a user needs to input new credentials or to manually refresh token. The connection keeps its connection ID. When the user authorizes, the connection's tags are replaced by the ones built from tags and end_user. If that leaves no tags, for example when neither is passed or tags is {}, the connection keeps its existing tags.

Authorization

bearerAuth
headerAuthorizationBearer <token>

An Environment API key from your Tenklo environment, or an Account API key for account-level endpoints.

Request Body

application/json
  1. body
connection_id*string
integration_id*string
tags?

Connection tags (key/value strings). Keys are normalized to lowercase.

Propertiesproperties <= 10
end_user?Deprecated

Deprecated, use tags instead

organization?Deprecated

Deprecated, use tags instead

integrations_config_defaults?
overrides?
webhook_url_override?webhook_url_override

Override the environment's webhook URLs for the connection created by this session. When set, that connection's webhooks are sent only to this URL (the environment's primary and secondary URLs are bypassed).

Response Body

Successfully created a connect session

application/json
  1. response
data*
Example Request
curl -X POST 'https://api.tenklo.dev/connect/sessions/reconnect' \  -H 'Content-Type: application/json' \  -d '{  "connection_id": "string",  "integration_id": "string"}'
Example Response
{  "data": {    "token": "string",    "connect_link": "string",    "expires_at": "2019-08-24T14:15:22Z"  }}