Finding IDs
Which endpoint returns each ID you need to call the rest of the API.
Most calls take an id: a location's store_id, a review's review_id, a plan's plan_id. This page says where each one comes from.
Use your own IDs where you can
You don't have to store our ids at all. When you create an account or location, attach your own identifier as client_account_id or client_location_id. Most endpoints that take an account or location accept your id in place of ours; each endpoint page says whether it does. This keeps your system the source of truth and saves a lookup on every call.
Naming
Three names appear for the same id: company_id, brand_id, and account_id all mean an account's id. They're identical values; the different names are historical. Where an endpoint uses one, pass the account's id. In new pages we say account_id. Similarly store_id and location mean the same thing: store_id is the location's id.
IDs are integers unless noted. Pass them in the path, body or query exactly as eachendpoint's page documents. In the Postman collection, most list/create requests have a
test script that captures the returned id into a{{…Id}}variable automatically, so
later requests are pre-filled.
Core resources
| Foreign key | Identifies | Get it from |
|---|---|---|
store_id | A location | List locations — account · List locations — partner |
account_id (also appears as company_id, brand_id) | An account | List accounts — partner · List child accounts — account |
review_site_id | A review site (publisher) | Review-site catalogue · Review sites for a location |
store_review_site_id | A location's specific review-site link | List review sites for a location |
city_id | A city (address lookup) | List cities |
companyindustry_id | An industry | List account industries |
partner_id | Your own partner account | Returned by Check your token as company.id (when bundle_id = 1) |
Plans
| Foreign key | Identifies | Get it from |
|---|---|---|
plan_id | A plan | List plans — partner · List plans — account |
Users
| Foreign key | Identifies | Get it from |
|---|---|---|
user_id | A user | List users |
Campaigns & templates
| Foreign key | Identifies | Get it from |
|---|---|---|
campaign_id | A campaign | List campaigns |
email_template_id | An email template | List email templates |
sms_template_id | An SMS template | List SMS templates |
landing_page_id | A landing-page template | List landing-page templates |
file_header_id | A CSV automation file-header set | List automation campaigns |
QR codes
| Foreign key | Identifies | Get it from |
|---|---|---|
qr_code_id | A QR code | List QR codes |
template_id (QR) | A QR template | List QR templates |
Reviews, responses & AI
| Foreign key | Identifies | Get it from |
|---|---|---|
review_id | A review | Get reviews for a location |
ai_response_id | A stored AI response | List AI responses for a review |
Reports
| Foreign key | Identifies | Get it from |
|---|---|---|
competitive_report_id | A competitive report | List competitive reports |
insight_report_id | An insight report | Submit insight report (returned on submit) |
report_id | A saved email / user report | List email reports |
Widgets
| Foreign key | Identifies | Get it from |
|---|---|---|
widget_type_id | A widget type | List widget types |
Webhooks & notifications
| Foreign key | Identifies | Get it from |
|---|---|---|
webhook_subscription_id | A webhook subscription | List subscriptions |
notification_id | An error notification | List error notifications |
Auth & onboarding
| Foreign key | Identifies | Get it from |
|---|---|---|
client_id (OAuth) | Your app credentials | The dashboard's API Keys page (shown in the credentials list) |
bulk_import_id | A bulk-import job | Bulk import accounts + locations (returned on upload) |
Updated about 1 month ago
