Guides · Setup · 5 min

Connect Toast to Pickup Signal

Do this once, on a computer. After that, orders rung up on Toast appear on your pickup board by themselves. If someone else manages your Toast account, send them this page.

By Tien, founder of Pickup Signal · October 2026

Before you start

• Toast Restaurant Management Suite Essentials or higher. The Starter Kit can't create API credentials.
• Admin access to Toast Web.
• Your Pickup Signal account, with this shop added.
• About five minutes.

In Toast Web: make API credentials

1. Sign in to Toast Web.
2. Go to Integrations → Toast API access → Manage credentials.
3. Click the arrow beside Create new credentials, then choose Standard API.
4. Name them Pickup Signal.
5. Tick these scopes:
   • orders:read (required)
   • guest.pi:read (puts names on tickets)
   • restaurants:read (your shop's name)
6. Pick your location, then click Confirm.
7. Copy the Client ID, Client secret and API access URL. Toast shows the client secret only once, so keep this tab open until you've pasted it.
8. Open the email Toast sends about the new credentials. It has your restaurant GUID. Copy that line.

In Pickup Signal: paste the credentials

9. On your Pickup Signal dashboard, click Order sources on your shop. You can also click Connect register in the Getting live checklist.
10. Click Toast.
11. Paste the Client ID, Client secret and API access URL into the fields with those names.
12. Paste the line from Toast's email into Restaurant GUID. Pickup Signal picks out the GUID.
13. Click Connect Toast.

Pickup Signal shows the restaurant it connected to. Orders now reach your board within 5 minutes. The webhook below makes them arrive as soon as they're rung up.

Add the Orders webhook

14. In Pickup Signal, click Copy next to Webhook URL.
15. In Toast Web, go to Integrations → Toast API access → Manage webhooks → + Add webhook.
16. For credentials, choose Pickup Signal.
17. For Event category, choose Orders.
18. Paste the webhook URL.
19. Enter any name and your email for alerts, then click Save.
20. Open the new webhook and copy its secret key.
21. Back in Pickup Signal, paste it into Webhook secret key and click Save and check.
22. Ring up a test order on Toast. When Toast sends it, Pickup Signal checks its signature. Once you see Toast’s signature checks out, orders arrive the moment they're rung up.

If the check takes a while, orders still reach your board: Pickup Signal also checks Toast every 5 minutes.

Names or numbers

In-store Toast orders may arrive without a customer name. The board then shows the order number. While you wait for the test order, setup tells you how many of your recent Toast orders came with a name.

If you see an error

These are the messages Pickup Signal can show during setup, and what to do about each.

If your credentials stop working

If your dashboard says Toast stopped sending orders, the credentials were deleted, or the secret was rotated, in Toast Web.

1. Make new credentials in Toast Web (steps 2 to 8).
2. On your dashboard, click Paste new credentials.
3. Paste the four values, then click Connect Toast.
4. Pickup Signal shows the webhook step again. If you made a new webhook in Toast, paste its secret key.

Orders from the last 30 minutes come back too.

To disconnect

• In Pickup Signal: on your dashboard, open the ··· menu on the shop, click Disconnect Toast…, then Disconnect Toast. This deletes the credentials from Pickup Signal right away. Your board and TVs stay as they are, and staff can add orders by hand.
• In Toast Web: go to Integrations → Toast API access → Manage credentials and delete the Pickup Signal credentials. Access ends when Pickup Signal's current Toast sign-in expires, which takes a short time.

Related: Connect Clover to Pickup Signal · Integrations & API · FAQ

More guides: Guides · How to set up an order-ready TV in a coffee shop · TV & tablet setup