Release | B2B Webhook

Receive a POST notification with release metadata when a connected B2B partner shares a new release with your account.

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 <your-configured-endpoint>

Sent each time a connected tour operator shares a release with your account.

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.

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

{
    "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.