connections

Create Session

Changed on

Mint the token the browser uses to open the provider's own consent screen.

Only owners and admins may start this: connecting an account is what decides what the agent can see for everyone in the tenant.

post/api/connections/{provider}/session

Request

  • Base URL: https://api.heymetra.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.heymetra.com/api/connections/{provider}/session
  • Auth: none declared

Path parameters

provider'google_ads' | 'meta_ads' | 'meta_instagram' | 'meta_page' | 'ga4' | 'gsc' | 'zoho_crm' | 'zoho_salesiq' | 'zoho_marketing' | 'telegram' | 'slack' | 'email' | 'adapty' | 'trendyol' | 'revenuecat' | 'appsflyer' | 'app_store_connect' | 'woocommerce' | 'shopify' | 'stripe' | 'posthog' | 'jira' | 'google_calendar' | 'google_meet' | 'hepsiburada' | 'n11' | 'ciceksepeti' | 'amazon_seller' | 'ikas' required

Query parameters

writeboolean
marketplacestring nullable
store_namestring nullable

Headers

authorizationstring nullable
x-workspace-idstring nullable

Response

Successful Response

integration_idstring required
session_tokenstring required
expires_atstring required
connection_configobject
authorize_urlstring nullable

Changes

  • 488ce9683884Revision changes
    • info

      added the new optional query request parameter store_name

    • info

      added the new enum value ikas to the path request parameter provider

    • info

      added the optional property to the response with the status

  • b72baf954a36Revision changes
    • info

      added the new optional query request parameter marketplace

    • info

      added the optional property to the response with the status