Skip to content

HighLevel: Users schemas

8 HighLevel schemas with complete fields and constraints.

← Users operations · All schemas

Delete User — response body

FieldTypePresenceDescription and constraints
$objectRoot
messagestringOptionalMessage describing the result of the deletion request
succeededbooleanOptionalIndicates whether the user deletion was queued successfully

Filter Users by Email — request body — body

FieldTypePresenceDescription and constraints
$objectRoot
companyIdstringRequired within parentCompany ID to filter users
deletedbooleanOptionalFilter deleted users
Default: false
emailsstringRequired within parentComma-separated list of email addresses to filter users
limitstringOptionalNo of results to be limited before returning the result
Default: 25
projectionstringOptionalProjection fields to return. Use "all" for all fields, or specify comma-separated field names. Default returns only id and email
skipstringOptionalNo of results to be skipped before returning the result
Default: 0

Get User — response body

FieldTypePresenceDescription and constraints
$objectRoot
emailstringOptionalEmail address of the user
extensionstringOptionalPhone extension of the user
firstNamestringOptionalFirst name of the user
idstringOptionalUnique identifier of the user
lastNamestringOptionalLast name of the user
lcPhoneobjectOptionalLC Phone Inbound Phone Numbers
namestringOptionalFull name of the user
permissionsJSONOptionalUser permissions controlling access to various features
permissions (allOf 1)ModelAll variants applyExpand Get User — response body — permissions adwords Reporting Enabled, affiliate Manager Enabled, agent Reporting Enabled, appointments Enabled, assigned Data Only, attributions Reporting Enabled, blogging Enabled, bot Service, bulk Requests Enabled, campaigns Enabled, campaigns Read Only, cancel Subscription Enabled, communities Enabled, contacts Enabled, content Ai Enabled, conversations Enabled, dashboard Stats Enabled, export Payments Enabled, facebook Ads Reporting Enabled, funnels Enabled, invoice Enabled, lead Value Enabled, marketing Enabled, membership Enabled, online Listings Enabled, opportunities Enabled, payments Enabled, phone Call Enabled, record Payment Enabled, refunds Enabled, reviews Enabled, settings Enabled, social Planner, tags Enabled, triggers Enabled, websites Enabled, workflows Enabled, workflows Read Only
phonestringOptionalPhone number of the user
platformLanguagestringOptionalPlatform language preference for the user
Known values: en_US, es, fr_CA, fr_FR, nl, de, pt_PT, pt_BR, it, sv, da, fi, no
rolesJSONOptionalRole and access configuration for the user
roles (allOf 1)ModelAll variants applyExpand Get User — response body — roles location Ids, restrict Sub Account, role, type
scopesstringOptionalList of OAuth scopes granted to this user
Known values: campaigns.readonly, campaigns.write, calendars.readonly, calendars/events.write, calendars/groups.write, calendars.write, contacts.write, contacts/bulkActions.write, workflows.readonly, workflows.write, triggers.write, funnels.write, forms.write, surveys.write, quizzes.write, websites.write, medias.write, medias.readonly, opportunities.write, opportunities/leadValue.readonly, opportunities/bulkActions.write, pipelines.create, reporting/phone.readonly, reporting/adwords.readonly, reporting/facebookAds.readonly, reporting/attributions.readonly, prospecting/auditReport.write, reporting/reports.readonly, reporting/agent.readonly, reporting/reports.write, reporting/stats.export, payments.write, payments/records.write, payments/orders.readonly, payments/orders.export, payments/orders.import, payments/orders.collectPayment, payments/subscriptions.readonly, payments/subscriptions.write, payments/subscriptions.update, payments/subscriptions.export, payments/subscriptions.pauseResumeCancel, payments/subscriptions.sharePaymentMethod, payments/transactions.readonly, payments/transactions.export, payments/transactions.import, payments/transactions.refund, payments/transactions.viewReceipts, payments/taxesSettings.readonly, payments/settings.readonly, payments/taxesSettings.updateInclusiveExclusive, payments/taxesSettings.manageRates, payments/taxesSettings.configureAutomatic, products.readonly, products.write, products.delete, products.duplicate, products.bulkActions, payments/settings.write, payments/settings.configureReceipt, payments/settings.configureSubscription, invoices.write, invoices.readonly, invoices/schedule.readonly, invoices/schedule.write, invoices/template.readonly, invoices/template.write, reputation/review.write, reputation/listing.write, reputation/reviewsAIAgents.write, reputation/gbp.write, conversations.write, conversations.readonly, conversations/message.readonly, conversations/message.write, contentAI.write, ai-studio.readonly, ai-studio.write, dashboard/stats.readonly, locations/tags.write, locations/tags.readonly, marketing.write, eliza.write, settings.write, socialplanner/post.write, socialplanner/account.readonly, socialplanner/account.write, socialplanner/category.readonly, socialplanner/category.write, socialplanner/csv.readonly, socialplanner/csv.write, socialplanner/group.write, socialplanner/hashtag.readonly, socialplanner/hashtag.write, socialplanner/oauth.readonly, socialplanner/oauth.write, socialplanner/post.readonly, socialplanner/recurring.readonly, socialplanner/recurring.write, socialplanner/review.readonly, socialplanner/review.write, socialplanner/rss.readonly, socialplanner/rss.write, socialplanner/search.readonly, socialplanner/setting.readonly, socialplanner/setting.write, socialplanner/stat.readonly, socialplanner/tag.readonly, socialplanner/tag.write, socialplanner/filters.readonly, socialplanner/medias.readonly, socialplanner/medias.write, socialplanner/watermarks.readonly, socialplanner/watermarks.write, socialplanner/metatag.readonly, socialplanner/facebook.readonly, socialplanner/linkedin.readonly, socialplanner/twitter.readonly, socialplanner/notification.readonly, socialplanner/notification.write, socialplanner/snapshot.readonly, socialplanner/snapshot.write, marketing/affiliate.write, blogs.write, membership.write, communities.write, gokollab.write, certificates.write, certificates.readonly, adPublishing.write, adPublishing.readonly, prospecting.write, prospecting.readonly, prospecting/reports.readonly, private-integration-location.readonly, private-integration-location.write, private-integration-company.readonly, private-integration-company.write, native-integrations.readonly, native-integrations.write, wordpress.write, wordpress.read, custom-menu-link.write, qrcodes.write, users/team-management.write, users/team-management.readonly, loginas.write, users-sso-login-management.write, users-sso-login-management.readonly, sso-config.write, snapshots/api.readonly, snapshots/api.create, snapshots/api.edit, snapshots/api.push, snapshots/api.refresh, snapshots/api.share, snapshots/api.delete, internaltools.location-transfer.write, internaltools.location-transfer.readonly, affiliateportal.write, affiliateportal.readonly, companies.write, internaltools.billing.write, internaltools.billing.readonly, internaltools.billing-common.readonly, internaltools.billing-common.write, voice-ai-agents.write, voice-ai-agents.readonly, voice-ai-common.readonly, voice-ai-common.write, voice-ai-agent-goals.readonly, voice-ai-agent-goals.write, voice-ai-dashboard.readonly, agency/launchpad.write, agency/launchpad.readonly, launchpad/location.write, launchpad/location.readonly, text-ai-agents.write, text-ai-agent-goals.readonly, text-ai-agent-goals.write, text-ai-agent-training.write, text-ai-agents-dashboard.readonly, locations.create, locations.delete, askai.write, copilot.readonly, locations.export.list, locations.features-limits.manage, locations.pause-resume, locations.agency-subaccounts.manage, locations.billing.manage, locations.details.manage, audit-logs.readonly, audit-logs.export

Referenced models: Get User — response body — permissions adwords Reporting Enabled, affiliate Manager Enabled, agent Reporting Enabled, appointments Enabled, assigned Data Only, attributions Reporting Enabled, blogging Enabled, bot Service, bulk Requests Enabled, campaigns Enabled, campaigns Read Only, cancel Subscription Enabled, communities Enabled, contacts Enabled, content Ai Enabled, conversations Enabled, dashboard Stats Enabled, export Payments Enabled, facebook Ads Reporting Enabled, funnels Enabled, invoice Enabled, lead Value Enabled, marketing Enabled, membership Enabled, online Listings Enabled, opportunities Enabled, payments Enabled, phone Call Enabled, record Payment Enabled, refunds Enabled, reviews Enabled, settings Enabled, social Planner, tags Enabled, triggers Enabled, websites Enabled, workflows Enabled, workflows Read Only, Get User — response body — roles location Ids, restrict Sub Account, role, type

Get User — response body — permissions adwords Reporting Enabled, affiliate Manager Enabled, agent Reporting Enabled, appointments Enabled, assigned Data Only, attributions Reporting Enabled, blogging Enabled, bot Service, bulk Requests Enabled, campaigns Enabled, campaigns Read Only, cancel Subscription Enabled, communities Enabled, contacts Enabled, content Ai Enabled, conversations Enabled, dashboard Stats Enabled, export Payments Enabled, facebook Ads Reporting Enabled, funnels Enabled, invoice Enabled, lead Value Enabled, marketing Enabled, membership Enabled, online Listings Enabled, opportunities Enabled, payments Enabled, phone Call Enabled, record Payment Enabled, refunds Enabled, reviews Enabled, settings Enabled, social Planner, tags Enabled, triggers Enabled, websites Enabled, workflows Enabled, workflows Read Only

FieldTypePresenceDescription and constraints
$objectRoot
adwordsReportingEnabledbooleanOptionalWhether AdWords reporting is enabled for this user
Default: false
affiliateManagerEnabledbooleanOptionalWhether the affiliate manager is enabled for this user
Default: true
agentReportingEnabledbooleanOptionalWhether agent reporting is enabled for this user
Default: true
appointmentsEnabledbooleanOptionalWhether appointments are enabled for this user
Default: true
assignedDataOnlybooleanOptionalWhether the user can only access data assigned to them
Default: false
attributionsReportingEnabledbooleanOptionalWhether attributions reporting is enabled for this user
Default: false
bloggingEnabledbooleanOptionalWhether blogging is enabled for this user
Default: true
botServicebooleanOptionalWhether the bot service is enabled for this user
Default: false
bulkRequestsEnabledbooleanOptionalWhether bulk requests are enabled for this user
Default: true
campaignsEnabledbooleanOptionalWhether campaigns are enabled for this user
Default: true
campaignsReadOnlybooleanOptionalWhether campaigns are in read-only mode for this user
Default: false
cancelSubscriptionEnabledbooleanOptionalWhether cancelling subscriptions is enabled for this user
Default: true
communitiesEnabledbooleanOptionalWhether communities are enabled for this user
Default: true
contactsEnabledbooleanOptionalWhether contacts are enabled for this user
Default: true
contentAiEnabledbooleanOptionalWhether Content AI is enabled for this user
Default: true
conversationsEnabledbooleanOptionalWhether conversations are enabled for this user
Default: true
dashboardStatsEnabledbooleanOptionalWhether dashboard statistics are enabled for this user
Default: true
exportPaymentsEnabledbooleanOptionalWhether exporting payments is enabled for this user
Default: true
facebookAdsReportingEnabledbooleanOptionalWhether Facebook Ads reporting is enabled for this user
Default: false
funnelsEnabledbooleanOptionalWhether funnels are enabled for this user
Default: true
invoiceEnabledbooleanOptionalWhether invoices are enabled for this user
Default: true
leadValueEnabledbooleanOptionalWhether lead value features are enabled for this user
Default: true
marketingEnabledbooleanOptionalWhether marketing features are enabled for this user
Default: true
membershipEnabledbooleanOptionalWhether membership features are enabled for this user
Default: false
onlineListingsEnabledbooleanOptionalWhether online listings are enabled for this user
Default: true
opportunitiesEnabledbooleanOptionalWhether opportunities are enabled for this user
Default: true
paymentsEnabledbooleanOptionalWhether payments are enabled for this user
Default: true
phoneCallEnabledbooleanOptionalWhether phone calls are enabled for this user
Default: true
recordPaymentEnabledbooleanOptionalWhether recording payments is enabled for this user
Default: true
refundsEnabledbooleanOptionalWhether refunds are enabled for this user
Default: true
reviewsEnabledbooleanOptionalWhether reviews are enabled for this user
Default: true
settingsEnabledbooleanOptionalWhether settings are enabled for this user
Default: true
socialPlannerbooleanOptionalWhether the social planner is enabled for this user
Default: true
tagsEnabledbooleanOptionalWhether tags are enabled for this user
Default: true
triggersEnabledbooleanOptionalWhether triggers are enabled for this user
Default: true
websitesEnabledbooleanOptionalWhether websites are enabled for this user
Default: false
workflowsEnabledbooleanOptionalWhether workflows are enabled for this user
Default: true
workflowsReadOnlybooleanOptionalWhether workflows are in read-only mode for this user
Default: false

Get User — response body — roles location Ids, restrict Sub Account, role, type

FieldTypePresenceDescription and constraints
$objectRoot
locationIdsarrayOptionalList of location IDs the user has access to
locationIds[]stringEach item
restrictSubAccountbooleanOptionalWhether the user is restricted to specific sub-accounts only
rolestringOptionalUser role within the account (admin or user)
typestringOptionalUser account type (account for sub-account users, agency for agency-level users)

Search Users — response body

FieldTypePresenceDescription and constraints
$objectRoot
countJSONOptional
count (anyOf 1)numberAlternativeTotal number of users matching the search criteria
count (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
usersarrayOptionalList of users matching the search criteria
users[]ModelEach itemExpand Search Users — response body — users item

Referenced models: Search Users — response body — users item

Search Users — response body — users item

FieldTypePresenceDescription and constraints
$objectRoot
deletedbooleanOptionalWhether the user has been deleted
emailstringOptionalEmail address of the user
extensionstringOptionalPhone extension of the user
firstNamestringOptionalFirst name of the user
idstringOptionalUnique identifier of the user
lastNamestringOptionalLast name of the user
lcPhoneobjectOptionalLC Phone Inbound Phone Numbers
namestringOptionalFull name of the user
permissionsJSONOptionalUser permissions controlling access to various features
permissions (allOf 1)ModelAll variants applyExpand Get User — response body — permissions adwords Reporting Enabled, affiliate Manager Enabled, agent Reporting Enabled, appointments Enabled, assigned Data Only, attributions Reporting Enabled, blogging Enabled, bot Service, bulk Requests Enabled, campaigns Enabled, campaigns Read Only, cancel Subscription Enabled, communities Enabled, contacts Enabled, content Ai Enabled, conversations Enabled, dashboard Stats Enabled, export Payments Enabled, facebook Ads Reporting Enabled, funnels Enabled, invoice Enabled, lead Value Enabled, marketing Enabled, membership Enabled, online Listings Enabled, opportunities Enabled, payments Enabled, phone Call Enabled, record Payment Enabled, refunds Enabled, reviews Enabled, settings Enabled, social Planner, tags Enabled, triggers Enabled, websites Enabled, workflows Enabled, workflows Read Only
phonestringOptionalPhone number of the user
platformLanguagestringOptionalPlatform language preference for the user
Known values: en_US, es, fr_CA, fr_FR, nl, de, pt_PT, pt_BR, it, sv, da, fi, no
rolesJSONOptionalRole and access configuration for the user
roles (allOf 1)ModelAll variants applyExpand Get User — response body — roles location Ids, restrict Sub Account, role, type
scopesstringOptionalList of OAuth scopes granted to this user
Known values: campaigns.readonly, campaigns.write, calendars.readonly, calendars/events.write, calendars/groups.write, calendars.write, contacts.write, contacts/bulkActions.write, workflows.readonly, workflows.write, triggers.write, funnels.write, forms.write, surveys.write, quizzes.write, websites.write, medias.write, medias.readonly, opportunities.write, opportunities/leadValue.readonly, opportunities/bulkActions.write, pipelines.create, reporting/phone.readonly, reporting/adwords.readonly, reporting/facebookAds.readonly, reporting/attributions.readonly, prospecting/auditReport.write, reporting/reports.readonly, reporting/agent.readonly, reporting/reports.write, reporting/stats.export, payments.write, payments/records.write, payments/orders.readonly, payments/orders.export, payments/orders.import, payments/orders.collectPayment, payments/subscriptions.readonly, payments/subscriptions.write, payments/subscriptions.update, payments/subscriptions.export, payments/subscriptions.pauseResumeCancel, payments/subscriptions.sharePaymentMethod, payments/transactions.readonly, payments/transactions.export, payments/transactions.import, payments/transactions.refund, payments/transactions.viewReceipts, payments/taxesSettings.readonly, payments/settings.readonly, payments/taxesSettings.updateInclusiveExclusive, payments/taxesSettings.manageRates, payments/taxesSettings.configureAutomatic, products.readonly, products.write, products.delete, products.duplicate, products.bulkActions, payments/settings.write, payments/settings.configureReceipt, payments/settings.configureSubscription, invoices.write, invoices.readonly, invoices/schedule.readonly, invoices/schedule.write, invoices/template.readonly, invoices/template.write, reputation/review.write, reputation/listing.write, reputation/reviewsAIAgents.write, reputation/gbp.write, conversations.write, conversations.readonly, conversations/message.readonly, conversations/message.write, contentAI.write, ai-studio.readonly, ai-studio.write, dashboard/stats.readonly, locations/tags.write, locations/tags.readonly, marketing.write, eliza.write, settings.write, socialplanner/post.write, socialplanner/account.readonly, socialplanner/account.write, socialplanner/category.readonly, socialplanner/category.write, socialplanner/csv.readonly, socialplanner/csv.write, socialplanner/group.write, socialplanner/hashtag.readonly, socialplanner/hashtag.write, socialplanner/oauth.readonly, socialplanner/oauth.write, socialplanner/post.readonly, socialplanner/recurring.readonly, socialplanner/recurring.write, socialplanner/review.readonly, socialplanner/review.write, socialplanner/rss.readonly, socialplanner/rss.write, socialplanner/search.readonly, socialplanner/setting.readonly, socialplanner/setting.write, socialplanner/stat.readonly, socialplanner/tag.readonly, socialplanner/tag.write, socialplanner/filters.readonly, socialplanner/medias.readonly, socialplanner/medias.write, socialplanner/watermarks.readonly, socialplanner/watermarks.write, socialplanner/metatag.readonly, socialplanner/facebook.readonly, socialplanner/linkedin.readonly, socialplanner/twitter.readonly, socialplanner/notification.readonly, socialplanner/notification.write, socialplanner/snapshot.readonly, socialplanner/snapshot.write, marketing/affiliate.write, blogs.write, membership.write, communities.write, gokollab.write, certificates.write, certificates.readonly, adPublishing.write, adPublishing.readonly, prospecting.write, prospecting.readonly, prospecting/reports.readonly, private-integration-location.readonly, private-integration-location.write, private-integration-company.readonly, private-integration-company.write, native-integrations.readonly, native-integrations.write, wordpress.write, wordpress.read, custom-menu-link.write, qrcodes.write, users/team-management.write, users/team-management.readonly, loginas.write, users-sso-login-management.write, users-sso-login-management.readonly, sso-config.write, snapshots/api.readonly, snapshots/api.create, snapshots/api.edit, snapshots/api.push, snapshots/api.refresh, snapshots/api.share, snapshots/api.delete, internaltools.location-transfer.write, internaltools.location-transfer.readonly, affiliateportal.write, affiliateportal.readonly, companies.write, internaltools.billing.write, internaltools.billing.readonly, internaltools.billing-common.readonly, internaltools.billing-common.write, voice-ai-agents.write, voice-ai-agents.readonly, voice-ai-common.readonly, voice-ai-common.write, voice-ai-agent-goals.readonly, voice-ai-agent-goals.write, voice-ai-dashboard.readonly, agency/launchpad.write, agency/launchpad.readonly, launchpad/location.write, launchpad/location.readonly, text-ai-agents.write, text-ai-agent-goals.readonly, text-ai-agent-goals.write, text-ai-agent-training.write, text-ai-agents-dashboard.readonly, locations.create, locations.delete, askai.write, copilot.readonly, locations.export.list, locations.features-limits.manage, locations.pause-resume, locations.agency-subaccounts.manage, locations.billing.manage, locations.details.manage, audit-logs.readonly, audit-logs.export

Referenced models: Get User — response body — permissions adwords Reporting Enabled, affiliate Manager Enabled, agent Reporting Enabled, appointments Enabled, assigned Data Only, attributions Reporting Enabled, blogging Enabled, bot Service, bulk Requests Enabled, campaigns Enabled, campaigns Read Only, cancel Subscription Enabled, communities Enabled, contacts Enabled, content Ai Enabled, conversations Enabled, dashboard Stats Enabled, export Payments Enabled, facebook Ads Reporting Enabled, funnels Enabled, invoice Enabled, lead Value Enabled, marketing Enabled, membership Enabled, online Listings Enabled, opportunities Enabled, payments Enabled, phone Call Enabled, record Payment Enabled, refunds Enabled, reviews Enabled, settings Enabled, social Planner, tags Enabled, triggers Enabled, websites Enabled, workflows Enabled, workflows Read Only, Get User — response body — roles location Ids, restrict Sub Account, role, type

Update User — request body — body

FieldTypePresenceDescription and constraints
$objectRoot
companyIdstringOptionalCompany/Agency Id. Required for Agency Level access
emailstringOptionalEmail update is no longer supported due to security reasons.
firstNamestringOptionalFirst name of the user
lastNamestringOptionalLast name of the user
locationIdsarrayOptionalList of sub-account location IDs the user should have access to
locationIds[]stringEach item
passwordstringOptionalNew password for the user account. All passwords will be required to meet the following criteria:

- Minimum 12 characters
- At least one uppercase letter (A–Z)
- At least one lowercase letter (a–z)
- At least one number (0–9)
- At least one special character (e.g., !, @, #, $)
permissionsJSONOptionalUser permissions controlling access to various features
permissions (allOf 1)ModelAll variants applyExpand Get User — response body — permissions adwords Reporting Enabled, affiliate Manager Enabled, agent Reporting Enabled, appointments Enabled, assigned Data Only, attributions Reporting Enabled, blogging Enabled, bot Service, bulk Requests Enabled, campaigns Enabled, campaigns Read Only, cancel Subscription Enabled, communities Enabled, contacts Enabled, content Ai Enabled, conversations Enabled, dashboard Stats Enabled, export Payments Enabled, facebook Ads Reporting Enabled, funnels Enabled, invoice Enabled, lead Value Enabled, marketing Enabled, membership Enabled, online Listings Enabled, opportunities Enabled, payments Enabled, phone Call Enabled, record Payment Enabled, refunds Enabled, reviews Enabled, settings Enabled, social Planner, tags Enabled, triggers Enabled, websites Enabled, workflows Enabled, workflows Read Only
phonestringOptionalPhone number of the user in E.164 format
platformLanguagestringOptionalPlatform language preference for the user
One of: en_US, es, fr_CA, fr_FR, nl, de, pt_PT, pt_BR, it, sv, da, fi, no
profilePhotostringOptionalURL of the user profile photo
rolestringOptionalUser role within the account (admin or user)
scopesarrayOptionalScopes allowed for users. Only scopes that have been passed will be enabled. If passed empty all the scopes will be get disabled
scopes[]stringEach itemOne of: campaigns.readonly, campaigns.write, calendars.readonly, calendars/events.write, calendars/groups.write, calendars.write, contacts.write, contacts/bulkActions.write, workflows.readonly, workflows.write, triggers.write, funnels.write, forms.write, surveys.write, quizzes.write, websites.write, medias.write, medias.readonly, opportunities.write, opportunities/leadValue.readonly, opportunities/bulkActions.write, pipelines.create, reporting/phone.readonly, reporting/adwords.readonly, reporting/facebookAds.readonly, reporting/attributions.readonly, prospecting/auditReport.write, reporting/reports.readonly, reporting/agent.readonly, reporting/reports.write, reporting/stats.export, payments.write, payments/records.write, payments/orders.readonly, payments/orders.export, payments/orders.import, payments/orders.collectPayment, payments/subscriptions.readonly, payments/subscriptions.write, payments/subscriptions.update, payments/subscriptions.export, payments/subscriptions.pauseResumeCancel, payments/subscriptions.sharePaymentMethod, payments/transactions.readonly, payments/transactions.export, payments/transactions.import, payments/transactions.refund, payments/transactions.viewReceipts, payments/taxesSettings.readonly, payments/settings.readonly, payments/taxesSettings.updateInclusiveExclusive, payments/taxesSettings.manageRates, payments/taxesSettings.configureAutomatic, products.readonly, products.write, products.delete, products.duplicate, products.bulkActions, payments/settings.write, payments/settings.configureReceipt, payments/settings.configureSubscription, invoices.write, invoices.readonly, invoices/schedule.readonly, invoices/schedule.write, invoices/template.readonly, invoices/template.write, reputation/review.write, reputation/listing.write, reputation/reviewsAIAgents.write, reputation/gbp.write, conversations.write, conversations.readonly, conversations/message.readonly, conversations/message.write, contentAI.write, ai-studio.readonly, ai-studio.write, dashboard/stats.readonly, locations/tags.write, locations/tags.readonly, marketing.write, eliza.write, settings.write, socialplanner/post.write, socialplanner/account.readonly, socialplanner/account.write, socialplanner/category.readonly, socialplanner/category.write, socialplanner/csv.readonly, socialplanner/csv.write, socialplanner/group.write, socialplanner/hashtag.readonly, socialplanner/hashtag.write, socialplanner/oauth.readonly, socialplanner/oauth.write, socialplanner/post.readonly, socialplanner/recurring.readonly, socialplanner/recurring.write, socialplanner/review.readonly, socialplanner/review.write, socialplanner/rss.readonly, socialplanner/rss.write, socialplanner/search.readonly, socialplanner/setting.readonly, socialplanner/setting.write, socialplanner/stat.readonly, socialplanner/tag.readonly, socialplanner/tag.write, socialplanner/filters.readonly, socialplanner/medias.readonly, socialplanner/medias.write, socialplanner/watermarks.readonly, socialplanner/watermarks.write, socialplanner/metatag.readonly, socialplanner/facebook.readonly, socialplanner/linkedin.readonly, socialplanner/twitter.readonly, socialplanner/notification.readonly, socialplanner/notification.write, socialplanner/snapshot.readonly, socialplanner/snapshot.write, marketing/affiliate.write, blogs.write, membership.write, communities.write, gokollab.write, certificates.write, certificates.readonly, adPublishing.write, adPublishing.readonly, prospecting.write, prospecting.readonly, prospecting/reports.readonly, private-integration-location.readonly, private-integration-location.write, private-integration-company.readonly, private-integration-company.write, native-integrations.readonly, native-integrations.write, wordpress.write, wordpress.read, custom-menu-link.write, qrcodes.write, users/team-management.write, users/team-management.readonly, loginas.write, users-sso-login-management.write, users-sso-login-management.readonly, sso-config.write, snapshots/api.readonly, snapshots/api.create, snapshots/api.edit, snapshots/api.push, snapshots/api.refresh, snapshots/api.share, snapshots/api.delete, internaltools.location-transfer.write, internaltools.location-transfer.readonly, affiliateportal.write, affiliateportal.readonly, companies.write, internaltools.billing.write, internaltools.billing.readonly, internaltools.billing-common.readonly, internaltools.billing-common.write, voice-ai-agents.write, voice-ai-agents.readonly, voice-ai-common.readonly, voice-ai-common.write, voice-ai-agent-goals.readonly, voice-ai-agent-goals.write, voice-ai-dashboard.readonly, agency/launchpad.write, agency/launchpad.readonly, launchpad/location.write, launchpad/location.readonly, text-ai-agents.write, text-ai-agent-goals.readonly, text-ai-agent-goals.write, text-ai-agent-training.write, text-ai-agents-dashboard.readonly, locations.create, locations.delete, askai.write, copilot.readonly, locations.export.list, locations.features-limits.manage, locations.pause-resume, locations.agency-subaccounts.manage, locations.billing.manage, locations.details.manage, audit-logs.readonly, audit-logs.export
scopesAssignedToOnlyarrayOptionalAssigned Scopes allowed for users. Only scopes that have been passed will be enabled. If passed empty all the assigned scopes will be get disabled
scopesAssignedToOnly[]stringEach itemOne of: campaigns.readonly, campaigns.write, calendars.readonly, calendars/events.write, calendars/groups.write, calendars.write, contacts.write, contacts/bulkActions.write, workflows.readonly, workflows.write, triggers.write, funnels.write, forms.write, surveys.write, quizzes.write, websites.write, medias.write, medias.readonly, opportunities.write, opportunities/leadValue.readonly, opportunities/bulkActions.write, pipelines.create, reporting/phone.readonly, reporting/adwords.readonly, reporting/facebookAds.readonly, reporting/attributions.readonly, prospecting/auditReport.write, reporting/reports.readonly, reporting/agent.readonly, reporting/reports.write, reporting/stats.export, payments.write, payments/records.write, payments/orders.readonly, payments/orders.export, payments/orders.import, payments/orders.collectPayment, payments/subscriptions.readonly, payments/subscriptions.write, payments/subscriptions.update, payments/subscriptions.export, payments/subscriptions.pauseResumeCancel, payments/subscriptions.sharePaymentMethod, payments/transactions.readonly, payments/transactions.export, payments/transactions.import, payments/transactions.refund, payments/transactions.viewReceipts, payments/taxesSettings.readonly, payments/settings.readonly, payments/taxesSettings.updateInclusiveExclusive, payments/taxesSettings.manageRates, payments/taxesSettings.configureAutomatic, products.readonly, products.write, products.delete, products.duplicate, products.bulkActions, payments/settings.write, payments/settings.configureReceipt, payments/settings.configureSubscription, invoices.write, invoices.readonly, invoices/schedule.readonly, invoices/schedule.write, invoices/template.readonly, invoices/template.write, reputation/review.write, reputation/listing.write, reputation/reviewsAIAgents.write, reputation/gbp.write, conversations.write, conversations.readonly, conversations/message.readonly, conversations/message.write, contentAI.write, ai-studio.readonly, ai-studio.write, dashboard/stats.readonly, locations/tags.write, locations/tags.readonly, marketing.write, eliza.write, settings.write, socialplanner/post.write, socialplanner/account.readonly, socialplanner/account.write, socialplanner/category.readonly, socialplanner/category.write, socialplanner/csv.readonly, socialplanner/csv.write, socialplanner/group.write, socialplanner/hashtag.readonly, socialplanner/hashtag.write, socialplanner/oauth.readonly, socialplanner/oauth.write, socialplanner/post.readonly, socialplanner/recurring.readonly, socialplanner/recurring.write, socialplanner/review.readonly, socialplanner/review.write, socialplanner/rss.readonly, socialplanner/rss.write, socialplanner/search.readonly, socialplanner/setting.readonly, socialplanner/setting.write, socialplanner/stat.readonly, socialplanner/tag.readonly, socialplanner/tag.write, socialplanner/filters.readonly, socialplanner/medias.readonly, socialplanner/medias.write, socialplanner/watermarks.readonly, socialplanner/watermarks.write, socialplanner/metatag.readonly, socialplanner/facebook.readonly, socialplanner/linkedin.readonly, socialplanner/twitter.readonly, socialplanner/notification.readonly, socialplanner/notification.write, socialplanner/snapshot.readonly, socialplanner/snapshot.write, marketing/affiliate.write, blogs.write, membership.write, communities.write, gokollab.write, certificates.write, certificates.readonly, adPublishing.write, adPublishing.readonly, prospecting.write, prospecting.readonly, prospecting/reports.readonly, private-integration-location.readonly, private-integration-location.write, private-integration-company.readonly, private-integration-company.write, native-integrations.readonly, native-integrations.write, wordpress.write, wordpress.read, custom-menu-link.write, qrcodes.write, users/team-management.write, users/team-management.readonly, loginas.write, users-sso-login-management.write, users-sso-login-management.readonly, sso-config.write, snapshots/api.readonly, snapshots/api.create, snapshots/api.edit, snapshots/api.push, snapshots/api.refresh, snapshots/api.share, snapshots/api.delete, internaltools.location-transfer.write, internaltools.location-transfer.readonly, affiliateportal.write, affiliateportal.readonly, companies.write, internaltools.billing.write, internaltools.billing.readonly, internaltools.billing-common.readonly, internaltools.billing-common.write, voice-ai-agents.write, voice-ai-agents.readonly, voice-ai-common.readonly, voice-ai-common.write, voice-ai-agent-goals.readonly, voice-ai-agent-goals.write, voice-ai-dashboard.readonly, agency/launchpad.write, agency/launchpad.readonly, launchpad/location.write, launchpad/location.readonly, text-ai-agents.write, text-ai-agent-goals.readonly, text-ai-agent-goals.write, text-ai-agent-training.write, text-ai-agents-dashboard.readonly, locations.create, locations.delete, askai.write, copilot.readonly, locations.export.list, locations.features-limits.manage, locations.pause-resume, locations.agency-subaccounts.manage, locations.billing.manage, locations.details.manage, audit-logs.readonly, audit-logs.export
twilioPhoneobjectOptionalPer-location inbound Twilio number in E.164 format, keyed by location id (Call and Voicemail Inbound Number for direct Twilio, not LC Phone). Replacement semantics: if you send twilioPhone in the request body, the stored map is replaced entirely with this object (not merged). Any location id omitted from the object is removed from the saved map. Omit the twilioPhone property entirely to leave existing numbers unchanged. Send an empty object {} to clear all per-location numbers. To clear a single location only, set that location id to an empty string "".
Additional keys: see wildcard field
twilioPhone.*stringAdditional keys
typestringOptionalUser account type (account for sub-account users, agency for agency-level users)

Referenced models: Get User — response body — permissions adwords Reporting Enabled, affiliate Manager Enabled, agent Reporting Enabled, appointments Enabled, assigned Data Only, attributions Reporting Enabled, blogging Enabled, bot Service, bulk Requests Enabled, campaigns Enabled, campaigns Read Only, cancel Subscription Enabled, communities Enabled, contacts Enabled, content Ai Enabled, conversations Enabled, dashboard Stats Enabled, export Payments Enabled, facebook Ads Reporting Enabled, funnels Enabled, invoice Enabled, lead Value Enabled, marketing Enabled, membership Enabled, online Listings Enabled, opportunities Enabled, payments Enabled, phone Call Enabled, record Payment Enabled, refunds Enabled, reviews Enabled, settings Enabled, social Planner, tags Enabled, triggers Enabled, websites Enabled, workflows Enabled, workflows Read Only

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.