# How To Integrate Postmates with CloudWaitress

## POSTMATES Integration

{% hint style="info" %}
**Which cities is Postmates available in?**

[This is the updated list of cities where Postmates is available](https://www.notion.so/cloudwaitresswiki/POSTMATES-Integration-ca913853d3ad493eb935d2a5f1120c30#8f10f90feb7a4b94ab35dfdbe0b14158)
{% endhint %}

## How to set-up CloudWaitress > Postmates integration

{% tabs %}
{% tab title="How to generate the Webhook?" %}

1 - Login to Postmates account at - partner.postmates.com

2 - Click Developer > Webhooks > Create Webhook

3 - Paste the API URL into the Production and Sandbox 'Webhooks' section. The API URL for the webhook can be found in your restaurant dasboard under settings > integrations > Postmates > Postmates Webhook URL

![](https://3208318816-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFSJWcCg8jLlMtgloE-%2F-MVtcUj5cv3Zl6myXeqM%2F-MVte9ERlIXLOlB1YE08%2FGenerate-postmates-webhook.png?alt=media\&token=1e9698a2-6ac6-48da-bb11-deb72c2c07ff)
{% endtab %}

{% tab title="Settings for testing" %}
For testing please make sure the 'wait times & auto statuses' are set as below;

Confirm = On at 0mins

Ready= On at 0min

![](https://3208318816-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFSJWcCg8jLlMtgloE-%2F-MVtcUj5cv3Zl6myXeqM%2F-MVteZz2KTFZj6ffVrKj%2Fpostmates-testing-settings-cloudwaitress.png?alt=media\&token=129acb50-1d3c-464b-8b0e-7fd812bb0310)
{% endtab %}

{% tab title="Required keys" %}
Below are the keys in Postmates that you will need to use when adding to the Shipday integration settings within the restaurant (Settings > Integrations > Postmates);

* Sandbox Key (Authentication Key for testing)
* Production Key (Authentication Key for live)
* Customer ID
* Signature Secret

![](https://3208318816-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFSJWcCg8jLlMtgloE-%2F-MVtcUj5cv3Zl6myXeqM%2F-MVtevhLfhb_QYZtLbcx%2Fpostmates-required-keys.png?alt=media\&token=4a18cb25-3ed0-469d-b696-f1f8da5d04ee)

Add the values from your Postmates account as per below (Settings > Integrations > Postmates);

![](https://3208318816-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFSJWcCg8jLlMtgloE-%2F-MVtcUj5cv3Zl6myXeqM%2F-MVtf7pXRZyRst__g6Wk%2Fsettings-integration-postmates.png?alt=media\&token=3a700560-37ee-49bb-84ff-58b2681b1d57)
{% endtab %}

{% tab title="UI for ordering" %}
Post mates will show during the checkout;

![Postmates delivery estimation in checkout](https://3208318816-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFSJWcCg8jLlMtgloE-%2F-MVtcUj5cv3Zl6myXeqM%2F-MVtfd9L6a9sX2oD55OW%2Fpostmates-checkout-ui.png?alt=media\&token=168d6c3e-d11c-42c9-8d69-dd04fdd252f3)

Postmates deliveries will show on the dashboard with the Postmates logo;

![Postmates logo shows in the CloudWaitress order dashboard](https://3208318816-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFSJWcCg8jLlMtgloE-%2F-MVtcUj5cv3Zl6myXeqM%2F-MVtfl5sBWYqBmqslujS%2Fpostmates-dashboard-ui.png?alt=media\&token=002ead85-72c4-4ab2-b189-f5c17c122d6c)
{% endtab %}
{% endtabs %}

## **Creating Postmates account**

Adding Postmates as your delivery driving service is simple and it will help increase your sales to customers who want order delivered right to their door.

**Setting up the Account and Payment method**

You will first need to create a Postmates Developer account which can be found at this link: <https://postmates.com/developer>

Once you enter in your restaurant information, you will be redirected to the Postmates Dashboard. In order to get the Postmates information we need, you have to enter a payment method so Postmates can charge it once an order is complete. To do this, click on “Add Payment Card”, enter your credit card information, and “Save”. Now that you have entered your credit card information, you will see some different “keys” show up on the screen.

## ESSENTIAL SETTINGS

{% hint style="warning" %}
IMPORTANT - The following settings must be applied for the Postmates integration to work.
{% endhint %}

**In Cloudwaitress the following settings must be applied;**

1\. Generate and add the webhook to Postmates (details above)

2\. Add the Postmates keys into restaurant dashboard. Settings > Integrations > Postmates.

3\. Settings > Services > Deliveries > Fees > None

![](https://3208318816-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFSJWcCg8jLlMtgloE-%2F-MVtcUj5cv3Zl6myXeqM%2F-MVtgcFH520Qrj8t15aq%2Fpostmates-essential-settings-1.png?alt=media\&token=2f4d2ce3-a303-4997-a9a4-9f24e82bd6ef)

4\. Settings > Services > Deliveries > General > Default Delivery Provider = Postmates

![](https://3208318816-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFSJWcCg8jLlMtgloE-%2F-MVtcUj5cv3Zl6myXeqM%2F-MVth2aw9NbXiERvLQPY%2Fpostmates-essential-settings-2.png?alt=media\&token=642024d2-5a2d-47e1-8ddb-8952e172ac04)

5\. Settings > Services > Deliveries > Wait Times & Auto Statuses

The following settings MUST be enabled;

* Time till confirm (minutes)
* Time Till Ready (minutes)
* Time till on route (mins)

Note: You can set different timings for these fields and you can use the other fields within this section, however this wont impact the Postmates integration.

![](https://3208318816-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFSJWcCg8jLlMtgloE-%2F-MVtcUj5cv3Zl6myXeqM%2F-MVthDpox8yxirFY0bRD%2Fpostmates-essential-settings-3.png?alt=media\&token=4e0b1fdd-5855-497f-b6e2-9d6e8df877a4)

## FAQ

* **What if I already have a Postmates account and are on their app? Do I still need a developer account?**

  You should already have access to the Developer section of Postmates, and all you will need to do is copy the existing keys into the CloudWaitress Admin Dashboard.