Appearance
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.
| Method | Path | What it does |
|---|---|---|
| GET | /integrations/hubspot | The account's HubSpot connection (never the token) |
| PUT | /integrations/hubspot | Connect HubSpot with a private app token (managers; plan feature hubspot.enabled) |
| DELETE | /integrations/hubspot | Disconnect 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
| Field | Type | Required | Description |
|---|---|---|---|
data | object | ||
data.connected | boolean | ||
data.portal_id | integer, nullable | ||
data.synced_count | integer | Contact updates sent. | |
data.last_synced_at | string (date-time), nullable | ||
data.last_error | string, 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
| Field | Type | Required | Description |
|---|---|---|---|
token | string | yes |
Responses
- 200 — The connection.
- 403 — Not allowed (not an administrator, or outside the token's abilities).
- 422 — Validation failed.
Response fields
| Field | Type | Required | Description |
|---|---|---|---|
data | object | ||
data.connected | boolean | ||
data.portal_id | integer, nullable | ||
data.synced_count | integer | Contact updates sent. | |
data.last_synced_at | string (date-time), nullable | ||
data.last_error | string, 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"