> For the complete documentation index, see [llms.txt](https://docs.zapiet.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zapiet.com/last-mile-api/creating-settings.md).

# 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.
