# Release | B2B Webhook
When a tour operator on GUIBO shares a new release with your account, GUIBO sends a `POST` request with the release metadata to a single webhook URL configured for your account.
The webhook fires for every shared release from any of your connected B2B partners — one endpoint covers all partners.
#### Setup
The webhook URL must be configured by GUIBO support — it cannot be set via the API or webportal.
1. Open a support ticket titled "Set up B2B Webhook"
2. Provide your HTTPS endpoint URL
3. GUIBO confirms once the webhook is active
#### Webhook call
`POST` \
``
Sent each time a connected tour operator shares a release with your account.
{% hint style="info" %}
**Recommended:** Use the `url` field (Trip Link) as the central link in your traveler communication. It gives travelers access to the Tour Guide App, Roadbook PDF, GPX files, and any booking attachments — and stays up to date if your partner changes booking data later.
{% endhint %}
**Headers**
| Name | Type | Description |
| -------------- | ------ | ------------------ |
| `Content-Type` | String | `application/json` |
**Request Body**
JSON object containing the release metadata.
| Field | Type | Description |
| ---------------------- | ------- | --------------------------------------------------------------------------- |
| `id` | Number | Internal release ID |
| `key` | String | Unique release key (UUID) |
| `link` | String | Trip Link slug |
| `url` | String | Full Trip Link URL - **central access link for travelers** |
| `bundleName` | String | Release name |
| `guidebookInternalId` | String | Internal guidebook ID |
| `downloadCode` | Number | Tour operator's booking reference |
| `operatorDownloadCode` | Number | Tour operator's booking reference |
| `sellerDownloadCode` | Number | Seller's booking reference (when applied by operator) |
| `arrivaldate` | String | Traveler arrival date (`YYYY-MM-DD`) |
| `departuredate` | String | Traveler departure date (`YYYY-MM-DD`) |
| `startdate` | String | Trip Link validity start (`YYYY-MM-DD`) |
| `enddate` | String | Trip Link validity end (`YYYY-MM-DD`) |
| `startDatetime` | Number | `startdate` in epoch milliseconds |
| `endDatetime` | Number | `enddate` in epoch milliseconds |
| `creation` | String | Release creation timestamp (ISO 8601) |
| `lang` | String | Language code (e.g. `de`, `en`) |
| `devices` | Number | Number of devices booked |
| `appEnabled` | Boolean | Tour Guide App is enabled |
| `appAvailable` | Boolean | Tour Guide App is available |
| `pdfEnabled` | Boolean | Roadbook PDF is enabled |
| `pdfAvailable` | Boolean | Roadbook PDF is available |
| `gpxEnabled` | Boolean | GPX files available for download |
| `positioning` | Boolean | In-app positioning feature enabled |
| `navigation` | Boolean | In-app navigation feature enabled |
| `tourguide` | Boolean | Group tourguide |
| `travelgroup` | Boolean | Travel group |
| `photocontest` | Boolean | Photo contest feature |
| `attributes` | Object | Same feature flags as `"0"`/`"1"` string values |
| `customized` | Boolean | Release has been customized |
| `disabled` | Boolean | Release is disabled |
| `locked` | Boolean | Release is locked |
| `primaryColor` | String | Seller brand primary color (hex) |
| `secondaryColor` | String | Seller brand secondary color (hex) |
| `androidUrl` | String | Tour Guide App Android store URL |
| `iosUrl` | String | Tour Guide App iOS store URL |
| `provider` | Object | Tour operator details (`id`, `oid`, `name`, `logo`, `type`, `color`, `app`) |
| `seller` | Object | Seller details (`id`, `oid`, `name`, `logo`, `type`, `color`, `app`) |
| `additionalAssets` | Array | Additional assets attached to the release |
| `accommodation` | Array | Accommodation entries |
| `text` | Array | Custom text pages |
**Example payload**
```json
{
"downloadCode": 23425,
"operatorDownloadCode": 23425,
"sellerDownloadCode": 23425,
"startdate": "2026-04-21",
"enddate": "2026-05-12",
"arrivaldate": "2026-04-23",
"departuredate": "2026-04-26",
"devices": 20,
"guidebookInternalId": "PfI58q",
"lang": "de",
"positioning": true,
"navigation": true,
"tourguide": false,
"travelgroup": false,
"photocontest": true,
"attributes": {
"navigation": "1",
"positioning": "1",
"travelgroup": "0",
"tourguide": "0"
},
"additionalAssets": [],
"accommodation": [],
"text": [],
"id": 557595,
"link": "aCTCuf",
"bundleName": "Bodensee Cycling Tour",
"creation": "2026-04-21T15:34:38.000+00:00",
"appEnabled": true,
"appAvailable": false,
"pdfEnabled": false,
"pdfAvailable": false,
"gpxEnabled": true,
"customized": false,
"disabled": false,
"locked": false,
"androidUrl": "https://play.google.com/store/apps/details?id=com.schneidergeo.guibo",
"iosUrl": "https://itunes.apple.com/us/app/guibo/id1375069250?ls=1&mt=8",
"primaryColor": "#f17a32",
"secondaryColor": "#ffffff",
"key": "178ca7a4-f3b8-41c9-8d72-35cd381de407",
"startDatetime": 1776722400000,
"endDatetime": 1778619600000,
"url": "https://trip-tst.guibo.travel/aCTCuf",
"provider": {
"id": "cpdqG3",
"oid": "HID",
"name": "GUIBO Travel",
"logo": "https://storage.googleapis.com/cloud.schneidergeo.com/graphics/logos/tst/cpdqG3_1759243805983.png",
"type": "GUIBO_STA",
"color": "#f17a32",
"app": {
"iosUrl": "https://itunes.apple.com/us/app/guibo/id1375069250?ls=1&mt=8",
"androidUrl": "https://play.google.com/store/apps/details?id=com.schneidergeo.guibo"
}
},
"seller": {
"id": "cpdqG3",
"oid": "HID",
"name": "GUIBO Travel",
"logo": "https://storage.googleapis.com/cloud.schneidergeo.com/graphics/logos/tst/cpdqG3_1759243805983.png",
"type": "GUIBO_STA",
"color": "#f17a32",
"app": {
"iosUrl": "https://itunes.apple.com/us/app/guibo/id1375069250?ls=1&mt=8",
"androidUrl": "https://play.google.com/store/apps/details?id=com.schneidergeo.guibo"
}
}
}
```
**Expected response**
GUIBO expects an HTTP `2xx` response from your endpoint to acknowledge successful receipt.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.guibo.travel/developers/releases-api/release-or-b2b-webhook.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.