Skip to content

Creating a user and set restrictions

You are viewing the next version (v6.7) of the documentation.
Click here to switch to the stable version (v6.6), or use the version switcher on the left to navigate between versions.

Creating a user and set restrictions

You can create a user by sending a POST request to the /api/user endpoint. The x-api-key header is required and can be set in the environment (API_AUTH_SECRET_KEY).

bash
curl -XPOST -H 'x-api-key: <secret>' -H "Content-type: application/json" -d '{
    "name": <name>,
    "email": <email>,
    "id": <id>,
    "password": <password>
}' '<sales_agent_instance_url>/api/user'

To restrict a user to viewing only specific customers, you can send a POST request to the /api/entity-restriction endpoint.

bash
curl -XPOST -H 'x-api-key: <secret>' -H "Content-type: application/json" -d '{
    "entity": "customer",
    "email": <user_email>,
    "criteria": {
      "filter": [{
        "field": "lastName",
        "type": "equals",
        "value": "Doe"
      }]
    }
}' '<sales_agent_instance_url>/api/entity-restriction'

In this example, the user with the email <user_email> will only be able to see customers with the last name "Doe". The criteria object supports the same fields as the shopware API. You can find more information about the criteria object in the documentation.

Further documentation of the available endpoints can be found in the API documentation.