connections

Select Accounts

Changed on

Persist the customer's choice.

The account ids are re-fetched from the provider rather than trusted from the request: a browser could otherwise post an id this grant does not cover.

post/api/connections/{provider}/accounts

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}/accounts
  • 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' | 'hepsiburada' | 'n11' | 'ciceksepeti' | 'amazon_seller' | 'ikas' required

Headers

authorizationstring nullable
x-workspace-idstring nullable

Request body

nango_connection_idstring required
account_idsstring[] required
write_enabledboolean required
shared_with_workspaceboolean

Response

Successful Response

idstring uuid required
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' | 'hepsiburada' | 'n11' | 'ciceksepeti' | 'amazon_seller' | 'ikas' required
account_idstring required
account_namestring nullable required
aliasstring nullable required
display_namestring required
is_activeboolean required
paused_for_planboolean required
write_enabledboolean required
ask_before_sendingboolean
currencystring nullable required
consent_versioninteger nullable
is_mineboolean
may_administerboolean
shared_with_workspaceboolean
referencestring required
identityobject required
credentialsobject
last_errorstring nullable required
created_atstring date-time required
grant_shape'separable' | 'read_only' | 'inseparable' | 'channel' required

What a customer's read-or-write choice can actually buy at this provider.

The choice is offered on every connector, because a customer deciding whether an assistant may change their account should not have to know which providers happen to model that as a scope. What differs is what the choice BUYS, and saying so is this enum's whole job: a screen that offers the same two options everywhere while one of them is unenforceable at three providers is worse than one that says which is which.

Changes

  • 877b0f87d6d0Revision changes
    • breaking

      removed the enum value google_calendar from the path request parameter provider

    • breaking

      removed the enum value google_meet from the path request parameter provider

    • info

      removed the google_calendar enum value from the / response property for the response status

    • info

      removed the google_meet enum value from the / response property for the response status

  • 488ce9683884Revision changes
    • warning

      added the new ikas enum value to the / response property for the response status

    • info

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