Get staff account

Request and response example

Request:

curl --location 'https://app.ecwid.com/api/v3/1003/staff/p3855016' \
--header 'Authorization: Bearer secret_ab***cd'

Response:

{
    "email": "[email protected]",
    "staffScopes": [
        "SALES_MANAGEMENT",
        "CATALOG_MANAGEMENT",
        "WEBSITE_MANAGEMENT",
        "MARKETING_MANAGEMENT",
        "REPORT_ACCESS",
        "SALES_CHANNELS_MANAGEMENT",
        "STORE_MANAGEMENT"
    ]
}

Access scopes

Requires the following access scope: read_staff

Path params

Param	Type	Description
storeId	number	Ecwid store ID.
staffAccountId	string	Staff account ID

Query params

All query params are optional.

Param	Type	Description
responseFields	string	Limit JSON response by specific fields. If specified, all missing fields will be removed from the response body. Example: `?responseFields=staffScopes`

Example of using responseFields param:

curl --location 'https://app.ecwid.com/api/v3/1003/staff/p3855016?responseFields=staffScopes' \
--header 'Authorization: Bearer secret_ab***cd'

{
    "staffScopes": [
        "SALES_CHANNELS_MANAGEMENT",
        "REPORT_ACCESS",
        "CATALOG_MANAGEMENT",
        "STORE_MANAGEMENT",
        "SALES_MANAGEMENT",
        "MARKETING_MANAGEMENT",
        "WEBSITE_MANAGEMENT"
    ]
}

Headers

The Authorization header with a secret access token is required.

Header	Format	Description
Authorization	`Bearer secret_ab***cd`	Access token of the application.

Response

A JSON object with the following fields:

Field	Type	Description
email	string	Staff account email.
staffScopes	Array of strings	Permissions enabled for the staff account. See: Get staff account scopes If empty, the account has all permissions. Check Help Center for more information.