Schedule and manage dock appointments for inbound shipments using the Opendock API

Steps

1. Create an Opendock carrier account and authenticate by POSTing your credentials to the /auth/login endpoint; the response returns a JWT token, which you include as Authorization: Bearer in all subsequent requests.
2. Search for the target warehouse using the /carrier/warehouse-search endpoint with a search string (warehouse name, address, or organization name) to retrieve the facility's Opendock ID.
3. Query available appointment slots for the warehouse by calling the availability endpoint with the facility ID, desired date range, and dock type (inbound or outbound); the response returns open time slots.
4. Book an appointment by POSTing to the appointment creation endpoint with the warehouse ID, selected slot, load details (commodity, quantity, weight), and reference numbers (PO number, BOL); confirm any custom fields required by that facility.
5. Receive the appointment confirmation including a confirmation number; store this against your shipment record in your TMS or OMS to track dock schedule adherence.
6. Monitor for appointment changes or cancellations via the Opendock streaming events API (Subspace) or by polling the appointment status endpoint; notify drivers and update dispatch plans accordingly.