POST api/Customer/{token}

Create or update customer details for the specified tour search

Request Information

URI Parameters

NameDescriptionTypeAdditional information
token

The tour search token

string

Required

Body Parameters

The customer input parameters

Customer
NameDescriptionTypeAdditional information
linkedAgentID

Agent code to which this customer acquistion will be attributed (set to NMP or an empty string for direct bookings)

integer

None.

title

Title, e.g. Dr, Master, Miss, Mr, Mrs, Ms, Mstr, Prof or Rev

string

None.

firstName

First name

string

None.

lastName

Last name

string

None.

dateOfBirth

Date of birth in the format YYYY-MM-DD, e.g. 1970-01-01

string

None.

gender

Gender, i.e. M or F

string

None.

address1

Address line 1

string

None.

address2

Address line 2 (optional)

string

None.

address3

Address line 3 (optional)

string

None.

town

Town or city

string

None.

county

County (optional)

string

None.

postCode

Post code, e.g. SM6 0BP

string

None.

country

Country, e.g. United Kingdom (optional)

string

None.

personalLandline

Personal landline phone, e.g. 02081231234 (optional)

string

None.

personalMobile

Personal mobile phone, e.g. 07951231234 (optional)

string

None.

businessLandline

Business landline phone, e.g. 02081231234 (optional)

string

None.

businessMobile

Business mobile phone, e.g. 07951231234 (optional)

string

None.

emailAddress

E-mail address

string

None.

marketingPreferences

List of selected marketing preferences

MarketingPreferences

None.

Request Formats

application/json, text/json

Sample:
{
  "linkedAgentID": 1,
  "title": "sample string 2",
  "firstName": "sample string 3",
  "lastName": "sample string 4",
  "dateOfBirth": "sample string 5",
  "gender": "sample string 6",
  "address1": "sample string 7",
  "address2": "sample string 8",
  "address3": "sample string 9",
  "town": "sample string 10",
  "county": "sample string 11",
  "postCode": "sample string 12",
  "country": "sample string 13",
  "personalLandline": "sample string 14",
  "personalMobile": "sample string 15",
  "businessLandline": "sample string 16",
  "businessMobile": "sample string 17",
  "emailAddress": "sample string 18",
  "marketingPreferences": {
    "post": "sample string 1",
    "email": "sample string 2",
    "mobile": "sample string 3",
    "landline": "sample string 4"
  }
}

Response Information

Resource Description

CustomerResponse
NameDescriptionTypeAdditional information
token

The tour search token

string

None.

response

The response object

Customer

None.

status

The response status

ResponseStatus

None.

success

An indication that the request was successfully completed or failed

boolean

None.

datestamp

The date and time that the request was completed

date

None.

Response Formats

application/json, text/json

Sample:
{
  "token": "sample string 1",
  "response": {
    "linkedAgentID": 1,
    "title": "sample string 2",
    "firstName": "sample string 3",
    "lastName": "sample string 4",
    "dateOfBirth": "sample string 5",
    "gender": "sample string 6",
    "address1": "sample string 7",
    "address2": "sample string 8",
    "address3": "sample string 9",
    "town": "sample string 10",
    "county": "sample string 11",
    "postCode": "sample string 12",
    "country": "sample string 13",
    "personalLandline": "sample string 14",
    "personalMobile": "sample string 15",
    "businessLandline": "sample string 16",
    "businessMobile": "sample string 17",
    "emailAddress": "sample string 18",
    "marketingPreferences": {
      "post": "sample string 1",
      "email": "sample string 2",
      "mobile": "sample string 3",
      "landline": "sample string 4"
    }
  },
  "status": {
    "code": 1,
    "message": "sample string 2"
  },
  "success": true,
  "datestamp": "2026-08-03T20:52:15.9743725+01:00"
}