Connect Session | Polytomic Docs

Returns trusted metadata for the authenticated Polytomic Connect session.

Returns the trusted metadata stored for a Polytomic Connect session. Authenticate with the opaque Connect token in the token query parameter.

The response includes the server-enforced connection name, fixed type or whitelist, bound connection ID, completion redirect, branding, and absolute expiration time.

Returns trusted metadata for the authenticated Polytomic Connect session. Returns the trusted metadata stored for a Polytomic Connect session. Authenticate with the opaque Connect token in the `token` query parameter. The response includes the server-enforced connection name, fixed type or whitelist, bound connection ID, completion redirect, branding, and absolute expiration time.

Authentication

AuthorizationBasic

This is the Polytomic deployment key (on-premises only)

AuthorizationBearer

This is the Polytomic API key

Response

dataobject

Errors

401

Unauthorized Error

$	curl https://app.polytomic.com/api/connections/connect/session \
>	-H "X-Polytomic-Version: X-Polytomic-Version" \
>	-H "Content-Type: application/json" \
>	-u "<username>:<password>"

1	{
2	"data": {
3	"connection_id": "248df4b7-aa70-47b8-a036-33ac447e668d",
4	"dark": true,
5	"expires_at": "2024-12-31T23:59:59Z",
6	"logo": "https://cdn.polytomic.com/assets/logo-polytomic.png",
7	"name": "Salesforce Production",
8	"organization_name": "Acme Corp",
9	"redirect_url": "https://app.acmecorp.com/dashboard",
10	"type": "salesforce",
11	"whitelist": [
12	"salesforce",
13	"hubspot",
14	"zendesk"
15	]
16	}
17	}

Authentication

Headers

Response

Errors