Jitsu

Jitsu is a same-day last-mile delivery network in the United States. Connect your Jitsu account to Bird and delivery orders are priced at checkout and dispatched to Jitsu.

For help with Jitsu pricing, coverage, or anything about your Jitsu account, contact the Jitsu team.

Requirements

1. An active Jitsu account and API key
2. A store in the United States
3. Local Delivery set up, with delivery days and time slots
4. A complete address on every location Jitsu collects from

Connect Jitsu

1. Click Settings, then Integrations.
2. Find Jitsu and open it.
3. Enter your Jitsu API Key and click Connect.

Bird verifies the key with Jitsu. The remaining settings appear once you’re connected.

Set up the webhook

This is what keeps your order statuses up to date. Do it once, right after connecting.

1. On the Jitsu card, click Webhook setup.
2. Copy the Webhook URL, the Secret header name, and the Webhook secret.
3. In your Jitsu webhook settings, add the URL, then add the header with the secret as its value. If you can’t find it, send all three to the Jitsu team and ask them to register the webhook.

Skip this and deliveries are still dispatched, but Bird won’t hear back when a driver picks up or delivers.

You can click Rotate to replace the secret at any time. The old one stops working straight away, so give Jitsu the new one.

Configure settings

Notification emails

Add the emails to alert if Bird can’t schedule a delivery. Separate them with commas.

You’re only emailed when a failure is final. Timeouts and outages are retried quietly.

Locations

• Tick the locations Jitsu delivers for. You don’t have to tick them all.
• Add a contact name and contact phone to every ticked location, so a driver can reach someone at pickup.

Order fulfillment

• Tick Fulfill order in Shopify when Jitsu delivery job is created to mark orders fulfilled and attach Jitsu tracking.
• Tick Send fulfillment notification to customer to email that tracking to the customer.
• Leave both off to fulfill orders yourself.

Configure Jitsu delivery rates

Want Jitsu’s own rate — not a flat Bird rate — to show at checkout? Here’s how.

Limitation: This requires Shopify’s Carrier-Calculated Shipping (CCS), the feature that lets Shopify ask Bird’s server for a rate in real time. Without CCS, Jitsu’s price can never reach checkout, however Jitsu itself is set up.

1. Turn on Bird Rates with CCS under Settings → Rates. You need CCS on your Shopify plan — see Shopify’s carrier-calculated shipping documentation.
2. Under Rates, turn on Enable Jitsu rates. Until CCS is on, this toggle stays disabled.
3. Set the rate name and description your customers see at checkout.
4. Optionally, turn on free delivery above a minimum order value, and add a handling fee (percentage and/or flat amount) on top of Jitsu’s quote.

A live Jitsu rate replaces your static delivery rates for those locations. If Jitsu can’t quote, no rate shows.

Click Save.

Dispatching an order

1. The customer picks a delivery date and time, and sees the Jitsu rate.
2. Mark the order Dispatched in Bird. This is what sends it to Jitsu — creating the order does not.
3. Jitsu collects from your location and delivers inside the window the customer chose.
4. Statuses update as the driver moves: out for delivery, then delivered, failed, or cancelled.

Jitsu quotes and dispatches as a same-day service, so the delivery window the customer picks needs to be one your Jitsu coverage can actually serve.

Disconnect Jitsu

1. Click Settings, then Integrations.
2. Find Jitsu and open it.
3. Click Disconnect and confirm.

Bird stops quoting and dispatching right away. Deliveries already with Jitsu are unaffected.

Notes

• Cancelling an order in Shopify cancels the Jitsu delivery.
• Marking the same order Dispatched twice won’t create a second delivery.
• Editing an order after dispatch does not update it at Jitsu. Change it there, or cancel and re-dispatch.
• Jitsu prices in USD.

Troubleshooting

No Jitsu rate at checkout. Confirm:

• Enable Jitsu rates and Bird Rates with CCS are both on (see Configure Jitsu delivery rates above)
• The location is ticked
• Both the pickup and delivery addresses are inside Jitsu’s coverage

Orders dispatch but statuses never change. The webhook isn’t registered, or the secret has been rotated since you gave it to Jitsu. Re-copy all three values from Webhook setup.

Nothing reached Jitsu. Check your notification emails — Bird emails the reason when a dispatch fails, usually a bad drop-off address, a missing phone, or a rejected API key. If there is no email, confirm the order was marked Dispatched in Bird.

---

Related Articles

• UniHop
• Stuart
• Local Delivery: Configure Availability
• How to Configure Delivery Rates
• How to View, Sort, and Filter Orders in Bird App