# Creating settings

Our settings feature lets you create merchant-configurable settings. These settings will show when a merchant activates your integration in Zapiet - Pickup + Delivery.

[![](https://zapiet-ltd-2e9268abd76f.intercom-attachments-7.com/i/o/525543624/ca4b83273e6b7cf37b08a8c5/faglALapsdODgire1nSv_24WEzf5z_nWYg.PNG-1619961577?expires=1725953400\&signature=c3d9e4ce101b5af9d47b3bf7f8ea8baea8dc01c304d4227e369d6132e04162b3\&req=cSIiE819m4NbFb4f3HP0gKLwA6MAOYA8JAvOCqElOCgvpNcFcZY2XdZQsB1x%0AUKvReF1B77xE6BVtKw%3D%3D%0A)](https://zapiet-ltd-2e9268abd76f.intercom-attachments-7.com/i/o/525543624/ca4b83273e6b7cf37b08a8c5/faglALapsdODgire1nSv_24WEzf5z_nWYg.PNG-1619961577?expires=1725953400\&signature=c3d9e4ce101b5af9d47b3bf7f8ea8baea8dc01c304d4227e369d6132e04162b3\&req=cSIiE819m4NbFb4f3HP0gKLwA6MAOYA8JAvOCqElOCgvpNcFcZY2XdZQsB1x%0AUKvReF1B77xE6BVtKw%3D%3D%0A)

You can use values merchants enter as variables in any request or a request header. These settings are often used to ask the merchant questions like:

* Do your orders order contain alcohol?
* Do your orders contain fragile items?
* Should we ask for ID on delivery?

## Creating a setting <a href="#h_0eab695a42" id="h_0eab695a42"></a>

You can choose between a few setting types:

* Text field
* Checkbox (True/False)
* Select
* Password

1. Go to the App Setup page.

   [![](https://downloads.intercomcdn.com/i/o/688861450/4d912114e109b1a55d2f8d27/image.png?expires=1725953400\&signature=ba505f2b3ce93c68917e848871e8596ed2ca722fd4a393c0b9423c01103abcd9\&req=cigvHs9%2FmYRfFb4f3HP0gGMVG4p6BnLCHeTFO%2F3riTGfIXCcSeTy8IWUX%2BiW%0AmII%3D%0A)](https://downloads.intercomcdn.com/i/o/688861450/4d912114e109b1a55d2f8d27/image.png?expires=1725953400\&signature=ba505f2b3ce93c68917e848871e8596ed2ca722fd4a393c0b9423c01103abcd9\&req=cigvHs9%2FmYRfFb4f3HP0gGMVG4p6BnLCHeTFO%2F3riTGfIXCcSeTy8IWUX%2BiW%0AmII%3D%0A)
2. Click Add Setting.

   [![](https://downloads.intercomcdn.com/i/o/688898732/2e11930c1d9ad0de0a46193a/image.png?expires=1725953400\&signature=55d646a649a6bb01e8b8104d69cb74f5f2ad8691fb5ab803fa83f75ae645c377\&req=cigvHsB2moJdFb4f3HP0gNtpByyBaJy50SmXgeaZxWftQNgBV%2FKXFuQqcbMj%0AGa4%3D%0A)](https://downloads.intercomcdn.com/i/o/688898732/2e11930c1d9ad0de0a46193a/image.png?expires=1725953400\&signature=55d646a649a6bb01e8b8104d69cb74f5f2ad8691fb5ab803fa83f75ae645c377\&req=cigvHsB2moJdFb4f3HP0gNtpByyBaJy50SmXgeaZxWftQNgBV%2FKXFuQqcbMj%0AGa4%3D%0A)
3. Choose a setting type.
4. Enter a name and description for your setting.

   [![](https://zapiet-ltd-2e9268abd76f.intercom-attachments-7.com/i/o/525543628/362e802943cba8075efd3076/lxZiGGwBgc1ZLnHfmrHBA45Fg_6NE5E1Ww.PNG-1619965166?expires=1725953400\&signature=4c6ef172b1d9650a274b1b4c0b4630011d6ebc3d84210d5d0be4514aff10fcb8\&req=cSIiE819m4NXFb4f3HP0gAKS9hxJp6fYiGRF4gtyopQ7fnoEyeYZtnYaCMif%0ApQY%3D%0A)](https://zapiet-ltd-2e9268abd76f.intercom-attachments-7.com/i/o/525543628/362e802943cba8075efd3076/lxZiGGwBgc1ZLnHfmrHBA45Fg_6NE5E1Ww.PNG-1619965166?expires=1725953400\&signature=4c6ef172b1d9650a274b1b4c0b4630011d6ebc3d84210d5d0be4514aff10fcb8\&req=cSIiE819m4NXFb4f3HP0gAKS9hxJp6fYiGRF4gtyopQ7fnoEyeYZtnYaCMif%0ApQY%3D%0A)
5. In this example, we are going to ask the merchant to select the type of vehicle they want to deliver their orders. The merchant must select from a pre-defined list of options. Click the "Select" field type and add the available options.\
   ​
6. Click Create setting.
7. Save changes at the top of the page.\
   ​

## Accessing settings in requests <a href="#h_3b387ea84e" id="h_3b387ea84e"></a>

Each setting will have its unique handle. You will see the handle below the setting name.

[![](https://zapiet-ltd-2e9268abd76f.intercom-attachments-7.com/i/o/525543630/fa2454c945e38b51fbff0009/HyVrmzRt0d0Je1VtqGOwZU6qNNhfPhEhYw.png-1619965564?expires=1725953400\&signature=9710ed67036d2cc69ef3c0b702aed7c6e03dd3c740265dee79b32f82d9f73f27\&req=cSIiE819m4JfFb4f3HP0gNmOUAXpXbygSgLs2pOmbG1qOyvWZMElKBADIwds%0Ag5URFnqFIOLBf1fn%2FA%3D%3D%0A)](https://zapiet-ltd-2e9268abd76f.intercom-attachments-7.com/i/o/525543630/fa2454c945e38b51fbff0009/HyVrmzRt0d0Je1VtqGOwZU6qNNhfPhEhYw.png-1619965564?expires=1725953400\&signature=9710ed67036d2cc69ef3c0b702aed7c6e03dd3c740265dee79b32f82d9f73f27\&req=cSIiE819m4JfFb4f3HP0gNmOUAXpXbygSgLs2pOmbG1qOyvWZMElKBADIwds%0Ag5URFnqFIOLBf1fn%2FA%3D%3D%0A)

You can access this value in any request including authentication headers by using the liquid variable:

```
{{ settings.customer_id }}
```

Let’s take a look at packages next.


---

# Agent Instructions: 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.zapiet.com/last-mile-api/creating-settings.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.
