> For the complete documentation index, see [llms.txt](https://docs.prestashop-project.org/1-5-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.prestashop-project.org/1-5-documentation/english-documentation/developer-guide/developer-tutorials/using-the-prestashop-web-service/chapter-1-creating-access-to-back-office.md).

# Chapter 1 - Creating Access to Back Office

You first need to create an access to the web service.

Go in the PrestaShop back-office, open the "Web service" page under the "Advanced Parameters", and then choose "Yes" for the "Enable PrestaShop Webservice".

In previous versions of PrestaShop, you had to create a `.htaccess` file (or edit the existing one) in order to make your web service work.

This is no longer the case in PrestaShop 1.5: the `.htaccess` will automatically be generated, while keeping your custom rules.

## Creating access <a href="#chapter1-creatingaccesstobackoffice-creatingaccess" id="chapter1-creatingaccesstobackoffice-creatingaccess"></a>

Open the "Web service" page under the "Advanced Parameters", and then click the "Add New" button to access the account configuration section. A long form appears:

* **Key**. Click the "Generate" button to generate an authentication key. You can also create your own (which must be 32 characters long), but using a generated key prevents wrong-doers from guessing your key.\
  &#x20;Using this key, you and other selected users will be able to access the web service.
* **Key description**. The description is not public, but make sure to put all the keywords pertaining to the use, so that you can find they key more quickly.
* **Status**. You can disable any key at any time.
* **Permissions**. This section is very important, as it enables you to assign rights for each resource you want to make available for this key. Indeed, you might want a user to have read and write access on some resources, but only read access on others – and no access to the more important ones.\
  &#x20;In the list of permissions, the left button allows you to define all the rights for a given resource. Select the resources you need to manipulate from your application; in our case check the first check box in the "customers" row and then press "Save".
* **Shop association**. This only appears in multistore mode.

If you define your own passkey, make sure it is very secure and that its rights are limited.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.prestashop-project.org/1-5-documentation/english-documentation/developer-guide/developer-tutorials/using-the-prestashop-web-service/chapter-1-creating-access-to-back-office.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
