Configure an integration

Change an attached integration's name, account address or booking event type with its stored key. Verified with the vendor first; nothing is saved if it refuses. Never takes a key.

PATCHhttps://app.trygtm.com/api/v1/integrations/{provider}
Scope
write

Path parameters

providerstringrequired
The integration, by provider id from list_integrations.google_calendarcalendlycal_comhubspotpipedriveattiosalesforcezohogohighlevelslackzapierwebhook

Headers

Idempotency-Keystringoptional
A key unique to this write, up to 255 characters. A retry carrying the same key returns the first response instead of running again. Kept for 24 hours.

Body

display_namestringoptional
The name shown on the integration's card.
external_account_idstringoptional
The account address the vendor's API needs: a portal id, user URI, calendar id or Slack channel. Never a key.
event_typestringoptional
Booking integrations: the event type meetings are booked as.

Request

curl -X PATCH https://app.trygtm.com/api/v1/integrations/google_calendar \
  -H "Authorization: Bearer $TRYGTM_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

Response

{
  "data": {
    "provider": "calendly",
    "status": "connected"
  }
}

Was this page helpful?