Sign in

v1

latestOpenAPI 3.0.12026-07-245277551.2 MB
ContactPerson

Update contact person for a profile (group, company, or travel agent)

put/group-profile/v1/contact-persons/{contactPersonId}

Path parameters

contactPersonIdinteger required

Contact person ID

Headers

x-property-idinteger

Property ID

x-organization-idinteger required

Organization ID

Request body

anonymizedboolean

Whether the contact is anonymized

prefixstring

Name prefix (Mr., Mrs., Dr., etc.)

firstNamestring

First name

lastNamestring

Last name

statusstring

Contact person status. Allowed values are ACTIVE, DELETED

profileIdinteger

Profile ID to update relationship for. Required when updating role, isMainContact, or relationshipType.

role'BOOKING_COORDINATOR' | 'ONSITE_COORDINATOR' | 'ROOMING_LIST_CONTACT' | 'ACCOUNTS_PAYABLE' | 'BILLING' | 'INVOICING' | 'ACCOUNT_MANAGER' | 'SALES_LEAD' | 'TRAVEL_AGENT_ACCOUNT_MANAGER' | 'CORPORATE_CONTACT' | 'AUTHORIZED_SIGNER' | 'EXECUTIVE_APPROVER' | 'MARKETING' | 'MAIN_POINT_OF_CONTACT' | 'ADMINISTRATIVE' | 'OTHER'

Role of person in the profile relationship

isMainContactboolean

Whether this person is the main contact for the profile

relationshipType'EMPLOYEE' | 'BOOKED_BY' | 'PART_OF_GROUP' | 'CONTACT' | 'GUEST' | 'DECISION_MAKER' | 'TRAVELER' | 'PRIMARY' | 'SECONDARY' | 'BILLING_CONTACT' | 'EMERGENCY_CONTACT'

Type of relationship between person and profile

Example request

{
  "prefix": "Mr.",
  "firstName": "John",
  "lastName": "Doe",
  "emails": [
    {
      "emailType": "work",
      "email": "john.doe@example.com"
    }
  ],
  "phones": [
    {
      "phoneType": "mobile",
      "phone": "+1-555-123-4567"
    }
  ],
  "status": "ACTIVE",
  "billingDetails": {
    "address1": "3033 5th Ave.",
    "address2": "Ste 100",
    "city": "San Diego",
    "country": "US",
    "document_number": "142-test",
    "name": "Denise Foreman",
    "postal_code": "60601",
    "phone": "1234567890",
    "state": "IL"
  },
  "role": "BOOKING_COORDINATOR",
  "relationshipType": "PRIMARY"
}

Response

Contact person updated successfully

idstring

Contact person ID

isMainContactboolean

Whether this is the main contact (from profile-person relationship, only populated when profileId filter was provided)

role'BOOKING_COORDINATOR' | 'ONSITE_COORDINATOR' | 'ROOMING_LIST_CONTACT' | 'ACCOUNTS_PAYABLE' | 'BILLING' | 'INVOICING' | 'ACCOUNT_MANAGER' | 'SALES_LEAD' | 'TRAVEL_AGENT_ACCOUNT_MANAGER' | 'CORPORATE_CONTACT' | 'AUTHORIZED_SIGNER' | 'EXECUTIVE_APPROVER' | 'MARKETING' | 'MAIN_POINT_OF_CONTACT' | 'ADMINISTRATIVE' | 'OTHER'

Role of person in the profile relationship

relationshipType'EMPLOYEE' | 'BOOKED_BY' | 'PART_OF_GROUP' | 'CONTACT' | 'GUEST' | 'DECISION_MAKER' | 'TRAVELER' | 'PRIMARY' | 'SECONDARY' | 'BILLING_CONTACT' | 'EMERGENCY_CONTACT'

Type of relationship between person and profile

startDatestring date

Start date of the relationship (from profile-person relationship, only populated when profileId filter was provided)

endDatestring date

End date of the relationship (from profile-person relationship, only populated when profileId filter was provided)

anonymizedboolean

Whether the contact is anonymized

prefixstring

Name prefix (Mr., Mrs., Dr., etc.)

firstNamestring

First name

lastNamestring

Last name

statusstring

Contact person status. Allowed values are ACTIVE, DELETED

createdAtstring date-time

Creation timestamp

updatedAtstring date-time

Last update timestamp

Example response

{
  "role": "BOOKING_COORDINATOR",
  "relationshipType": "PRIMARY",
  "prefix": "Mr.",
  "firstName": "John",
  "lastName": "Doe",
  "emails": [
    {
      "emailType": "work",
      "email": "john.doe@example.com"
    }
  ],
  "phones": [
    {
      "phoneType": "mobile",
      "phone": "+1-555-123-4567"
    }
  ],
  "status": "ACTIVE",
  "billingDetails": {
    "address1": "3033 5th Ave.",
    "address2": "Ste 100",
    "city": "San Diego",
    "country": "US",
    "document_number": "142-test",
    "name": "Denise Foreman",
    "postal_code": "60601",
    "phone": "1234567890",
    "state": "IL"
  }
}