Partner update

post

https://api.cupid.travel/api/partner-update

The API allows customers to update their partner's inventory through two different sources:

CSV Source: Upload and process a CSV file with hotel data. Requires file upload and header position parameters.

Connector Source: Pull data directly from a connector. No file upload or header parameters needed.

This API also provides the option to automatically run mapping for all active partners.

To experiment this API call, use the following sandbox API key:

88cd7ff1-e3af-4377-a5b0-38a4b483e92f

Body Params

partner_id

string

The ID of the partner to update

source

string

enum

Source of the inventory data. 'csv' for file upload, 'connector' for direct connector integration

Allowed:

header_id

string

hotel code position in your csv (starting from position 0) (Required when source is 'csv', ignored when source is 'connector')

header_name

string

hotel name position in your csv (starting from position 0) (Required when source is 'csv', ignored when source is 'connector')

header_address

string

hotel address position in your csv (starting from position 0) (Required when source is 'csv', ignored when source is 'connector')

header_city

string

hotel city position in your csv (starting from position 0) (Optional when source is 'csv', ignored when source is 'connector')

header_country_code

string

hotel country position in your csv (starting from position 0) (Required when source is 'csv', ignored when source is 'connector')

header_latitude

string

hotel latitude position in your csv (starting from position 0) (Recommended when source is 'csv', ignored when source is 'connector')

header_longitude

string

hotel longitude position in your csv (starting from position 0) (Recommended when source is 'csv', ignored when source is 'connector')

header_city_id

string

hotel city id position in your csv (starting from position 0) (Optional when source is 'csv', ignored when source is 'connector')

header_chain

string

hotel chain position in your csv (starting from position 0) (Optional when source is 'csv', ignored when source is 'connector')

header_type

string

hotel type position in your csv (starting from position 0) (Optional when source is 'csv', ignored when source is 'connector')

header_stars

string

hotel stars position in your csv (starting from position 0) (Optional when source is 'csv', ignored when source is 'connector')

header_zip_code

string

hotel postal code position in your csv (starting from position 0) (Optional when source is 'csv', ignored when source is 'connector')

file

Partner CSV file (Required when source is 'csv', not needed when source is 'connector')

run_mapping

string

Defaults to 0

boolean value (0 or 1) 1 : upload inventory and run mapping on all active mappings with same model

restrict_mapping_to_add_hotels

boolean

Defaults to false

boolean value (true or false) true :Run the mapping only on the newly added hotels from your inventory using the opportunities list from the previous mapping

action

string

Defaults to update

string value (add or update) : Choose 'update' to replace the existing hotels or 'add' to keep the existing hotels and add your file on top of it

Headers

x-api-key

string

required

API key for authentication

Responses

200Ok

401Unauthorized

404Not Found