
Before getting started, you should have both an OpenTable and PolyAI account.

Getting started
- Log in to the OpenTable for Groups dashboard.
- Use the OpenTable marketplace search to find the PolyAI tile.
- Click “Integrate with PolyAI”.
- You will be redirected to a page within OpenTable and asked for a unique identifier.
- If you are not yet a PolyAI customer, click “Contact PolyAI” and trigger a sales form.
- If you do have your identifier, enter it into the “Unique identifier” text field.
- PolyAI and OpenTable will enable your integration and contact you once it is ready to use.
See the OpenTable article on PolyAI for more details. You must contact PolyAI directly if you want to deactivate your integration.
Authorization
OpenTable uses OAuth 2.0 for secure access to its API. To get started:- Request your
client_id
andclient_secret
from OpenTable. - Exchange your credentials for an access token.
- Production:
https://oauth.opentable.com
- QA:
https://oauth-pp.opentable.com
POST
https://oauth.opentable.com/api/v2/oauth/token?grant_type=client_credentials
Submitting client credentials
Credentials are passed in theAuthorization
header as specified in the OAuth spec. Use the following steps to submit your client credentials:
Making a booking
Below is a simplified Python example referencing themake_booking
logic:
Next steps
- Error handling: In production, handle normal HTTP status codes like
401 Unauthorized
,403 Forbidden
, and400 Bad Request
. - Data validation: Add logic to ensure users provide all required fields (e.g., names, valid phone numbers, reservation token).
- Token renewal: Monitor token expiration and re-run the OAuth flow to obtain fresh tokens.