Skip to content

Integrations API ​

Connections of the account to other tools (HubSpot).

All paths are relative to https://your-site.com/api/v1. Send Authorization: Bearer <token> and Accept: application/json; see authentication and errors.

MethodPathWhat it does
GET/integrations/hubspotThe account's HubSpot connection (never the token)
PUT/integrations/hubspotConnect HubSpot with a private app token (managers; plan feature hubspot.enabled)
DELETE/integrations/hubspotDisconnect HubSpot (managers); contacts keep the links they got

GET /integrations/hubspot ​

The account's HubSpot connection (never the token)

Responses ​

  • 200 — The connection.
Response fields
FieldTypeRequiredDescription
dataobject
data.connectedboolean
data.portal_idinteger, nullable
data.synced_countintegerContact updates sent.
data.last_synced_atstring (date-time), nullable
data.last_errorstring, nullable
bash
curl -X GET "https://your-site.com/api/v1/integrations/hubspot" \
  -H "Authorization: Bearer $REPLORA_TOKEN" \
  -H "Accept: application/json"

PUT /integrations/hubspot ​

Connect HubSpot with a private app token (managers; plan feature hubspot.enabled)

The token is checked with HubSpot, which also gets two contact properties (replora_last_replay, replora_last_seen). Then, whenever a visitor is identified by email (identify with an email id or an email trait), the HubSpot contact with that email gets the link to the replay. Contacts are never created. Scopes: crm.objects.contacts.read, crm.objects.contacts.write, crm.schemas.contacts.write.

Request body ​

application/json, required

FieldTypeRequiredDescription
tokenstringyes

Responses ​

  • 200 — The connection.
  • 403 — Not allowed (not an administrator, or outside the token's abilities).
  • 422 — Validation failed.
Response fields
FieldTypeRequiredDescription
dataobject
data.connectedboolean
data.portal_idinteger, nullable
data.synced_countintegerContact updates sent.
data.last_synced_atstring (date-time), nullable
data.last_errorstring, nullable
bash
curl -X PUT "https://your-site.com/api/v1/integrations/hubspot" \
  -H "Authorization: Bearer $REPLORA_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"token":"text"}'

DELETE /integrations/hubspot ​

Disconnect HubSpot (managers); contacts keep the links they got

Responses ​

  • 204 — Disconnected.
  • 403 — Not allowed (not an administrator, or outside the token's abilities).
bash
curl -X DELETE "https://your-site.com/api/v1/integrations/hubspot" \
  -H "Authorization: Bearer $REPLORA_TOKEN" \
  -H "Accept: application/json"

Replora: see what your visitors see.