v1

latestOpenAPI 3.1.0© Copyright Partoo2026-07-26163503484.0 KB

Users

My user

This endpoint lets you retrieve all the information about your user

get/user/me

Query parameters

display_business_idsboolean

If true, response includes business_ids; a list of businesses the user has access to.
If false, response does not include business_ids.

⚠️ Note: The business_ids list is only populated for users with the BUSINESS_MANAGER role.

org_id_custom_fields_permissionsinteger

If you have access to more than one organization, you can specify the org_id of the organization for which you want to retrieve the permissions value.

Response

idstring

User id

org_idinteger

User organization id

first_namestring

User first name

last_namestring

User last name

emailstring email

User email

lang'fr' | 'en' | 'es' | 'it' | 'pt-br' | 'de' | 'ar' | 'nl' | 'pl' | 'cs' | 'ca' | 'sk' | 'pt' | 'lv' | 'ro' | 'bg' | 'hu'

Available language in the application

sidebar_pagesSidebarPagesFeatureEnum[]

List of features the user can access from the sidebar.

available_featuresFeature[]

The features the user has access to.

business_idsBusinessId[]

Populated only for BUSINESS_MANAGER role.

List of businesses ids the user can access.

Note: For a reliable way of getting all the businesses the user can access, use operation/searchBusinesses.

User role in the application

providerstring

User provider label

status'active' | 'invited'

User status in the application

disabledboolean

The state of the User account.

created_atnumber

Timestamp representing the date the user was created

shadow_user_idstring

Used internally at Partoo

custom_rolestring

Optional API identifier of a custom role to assign to the user. The value must match the api_id of one of the custom roles available to your organization.

If no custom role is given, users with the role GROUP_MANAGER or BUSINESS_MANAGER will automatically be assigned to the default built-in custom role associated with their role.

For more information about custom roles, see Managing User Permissions with Custom Roles

sso_onlyboolean

Prevent the user from connecting directly from the Partoo connection page.

This field is available for users whose organization has defined an SSO configuration.

This field can be edited by a user with the role ORG_ADMIN or PROVIDER.

permissionsstring[]

The permissions the user has access to.

For more information about permissions, see the Custom Roles guide.

Example response

{
  "id": "5309c3a237bbc544d8e26737",
  "org_id": 42,
  "first_name": "Perceval",
  "last_name": "de Galles",
  "email": "perceval@kaamelott.com",
  "lang": "fr",
  "business_ids": [
    "5409c35a97bbc544d8e26737"
  ],
  "accesses": [
    [
      1,
      2
    ],
    [
      1,
      3
    ]
  ],
  "role": "BUSINESS_MANAGER",
  "provider": "partoo",
  "status": "active",
  "created_at": 1615299414,
  "custom_role": "my_custom_role",
  "permissions": [
    "access_help_center",
    "access_intercom",
    "account_facebook_manage",
    "account_google_manage",
    "bulk_modification",
    "business_edit",
    "business_edit_address",
    "business_edit_address2",
    "business_edit_attributes",
    "business_edit_attributes_url",
    "business_edit_categories",
    "business_edit_city",
    "business_edit_code",
    "business_edit_coordinates",
    "business_edit_country",
    "business_edit_description_long",
    "business_edit_description_short",
    "business_edit_email",
    "business_edit_facebook_url",
    "business_edit_fax",
    "business_edit_full_name",
    "business_edit_menus",
    "business_edit_more_hours",
    "business_edit_name",
    "business_edit_open_hours",
    "business_edit_phone_number",
    "business_edit_photo_cover",
    "business_edit_photo_logo",
    "business_edit_photo_secondary",
    "business_edit_services",
    "business_edit_siret",
    "business_edit_specific_hours",
    "business_edit_status",
    "business_edit_twitter_url",
    "business_edit_website_url",
    "business_edit_zipcode",
    "business_management_create_business",
    "business_management_import_business",
    "business_management_manage_groups",
    "custom_fields_edit",
    "custom_fields_edit__Decimal",
    "custom_fields_edit__Photos de voyage",
    "custom_fields_see_disabled_fields",
    "diffusion",
    "feedback_management",
    "feedback_result_reply",
    "jim_configuration",
    "jim_configuration_manage",
    "lead_collection_manage",
    "listing_status",
    "listing_status_manage",
    "messages",
    "messages_answer_conversation_custom",
    "messages_answer_conversation_facebook",
    "messages_answer_conversation_instagram",
    "messages_answer_conversation_sms",
    "messages_answer_conversation_whatsapp",
    "messages_conversation_assign",
    "messages_conversation_close",
    "messages_conversation_reopen",
    "messages_conversation_starters",
    "messages_conversation_starters_manage",
    "messages_lead_collection_read",
    "messages_templates_manage",
    "messages_templates_use",
    "messages_whatsapp_account",
    "messages_whatsapp_account_manage",
    "messages_widget",
    "messages_widget_manage",
    "partner_connection",
    "partner_connection_manage",
    "posts",
    "posts_manage",
    "posts_manage_bulk",
    "presence_analytics",
    "review_analytics",
    "review_analytics_download",
    "review_booster",
    "review_booster_edit_expeditor_name",
    "review_booster_manage_sms_template",
    "review_booster_share_link",
    "review_booster_show_qr_code",
    "review_download",
    "review_flag",
    "review_manage_auto_reply_with_comments",
    "review_manage_auto_reply_without_comments",
    "review_manage_state",
    "review_management",
    "review_reply_negative_reviews",
    "review_reply_neutral_reviews",
    "review_reply_positive_reviews",
    "review_reply_suggestion",
    "review_reply_template_manage",
    "review_reply_template_use",
    "review_tags_assign",
    "review_tags_manage",
    "user_management",
    "user_management_manage"
  ]
}