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 each

endpoint'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 keyIdentifiesGet it from
store_idA locationList locations — account · List locations — partner
account_id (also appears as company_id, brand_id)An accountList accounts — partner · List child accounts — account
review_site_idA review site (publisher)Review-site catalogue · Review sites for a location
store_review_site_idA location's specific review-site linkList review sites for a location
city_idA city (address lookup)List cities
companyindustry_idAn industryList account industries
partner_idYour own partner accountReturned by Check your token as company.id (when bundle_id = 1)

Plans

Foreign keyIdentifiesGet it from
plan_idA planList plans — partner · List plans — account

Users

Foreign keyIdentifiesGet it from
user_idA userList users

Campaigns & templates

Foreign keyIdentifiesGet it from
campaign_idA campaignList campaigns
email_template_idAn email templateList email templates
sms_template_idAn SMS templateList SMS templates
landing_page_idA landing-page templateList landing-page templates
file_header_idA CSV automation file-header setList automation campaigns

QR codes

Foreign keyIdentifiesGet it from
qr_code_idA QR codeList QR codes
template_id (QR)A QR templateList QR templates

Reviews, responses & AI

Foreign keyIdentifiesGet it from
review_idA reviewGet reviews for a location
ai_response_idA stored AI responseList AI responses for a review

Reports

Foreign keyIdentifiesGet it from
competitive_report_idA competitive reportList competitive reports
insight_report_idAn insight reportSubmit insight report (returned on submit)
report_idA saved email / user reportList email reports

Widgets

Foreign keyIdentifiesGet it from
widget_type_idA widget typeList widget types

Webhooks & notifications

Foreign keyIdentifiesGet it from
webhook_subscription_idA webhook subscriptionList subscriptions
notification_idAn error notificationList error notifications

Auth & onboarding

Foreign keyIdentifiesGet it from
client_id (OAuth)Your app credentialsThe dashboard's API Keys page (shown in the credentials list)
bulk_import_idA bulk-import jobBulk import accounts + locations (returned on upload)

Did this page help you?