API reference

EventTemplates

Create an event template

Template API (v2)

Download OpenAPI description

TemplateApi.json

TemplateApi.yaml

Servers

Staging URL

https://apis.spotnana.com/

Spotnana mock server

https://developer.spotnana.com/_mock/openapi/templateapi/

Event Templates

APIs to create and manage event templates.

Operations

Create an event template

Request

This endpoint creates an event template.

Bodyapplication/json

namestringrequired

Name of the event template

descriptionstring

Description of the event

locationobject(EventLocation)

Location for an event

allowedBookingTypesArray of strings(EventAllowedBookingType)

Allowed booking types for the event template

Items Enum"AIR""HOTEL""CAR""RAIL"

bookingGuidelinesArray of AirBookingGuidelineWrapper (object) or HotelBookingGuidelineWrapper (object) or CarBookingGuidelineWrapper (object) or RailBookingGuidelineWrapper (object)(EventBookingGuideline)

A list of booking guideline for the event.

customFieldResponsesArray of objects(CustomFieldResponse)

Preselected custom field responses for the event template.

paymentMappingsArray of objects(PaymentAccessMapping)

Mappings i.e. access level, travel type information etc.

companyIdobject(CompanyId)required

Company id

companyId.idstring(uuid)required

Example: "f49d00fe-1eda-4304-ba79-a980f565281d"

internalNotesstring

Internal notes of the event

Example: "Use travelers default as payment method."

referenceUsersArray of objects(UserId)

Event group reference user ids

travelerTypesArray of strings(Persona)non-emptyrequired

Allowed traveler types for the event

Items Enum"UNKNOWN_PERSONA""EMPLOYEE""GUEST""PERSONAL""RELATIVE""ADHOC"

Example: ["EMPLOYEE"]

policyIdstring(uuid)

Policy associated with the event.

Example: "f7b3b3b3-7b3b-4b3b-8b3b-3b3b3b3b3b3b"

bookingStylestring(EventBookingStyle)required

Whether the event bookings will be self served by the traveler or would be arranged by an agent for the traveler.

Enum"SELF_SERVE""AGENT_MANAGED"

externalIdstring

External Id for the event

Example: "qwert123"

allowTravelersPolicystring(AllowTravelersPolicy)

Apply travelers policy when it is less restrictive.

Enum"ALLOWED""NOT_ALLOWED"

emailPreferencesobject(BucketEmailPreferences)

Email communication preferences based on bucket types.

curl -i -X POST \
  https://apis.spotnana.com/v2/event-templates \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "description": "string",
    "location": {
      "address": {
        "addressLines": [
          "Golden Gate Bridge"
        ],
        "administrativeArea": "CA",
        "administrativeAreaName": "California",
        "description": "San Francisco Home",
        "isDefault": true,
        "languageCode": "en",
        "locality": "San Francisco",
        "locationCode": "LAX",
        "organization": "Spotnana",
        "postalCode": "94130",
        "continentCode": "AF",
        "recipients": [
          "string"
        ],
        "regionCode": "US",
        "regionName": "America",
        "revision": 1,
        "sortingCode": "Jamaica",
        "sublocality": "string",
        "timezone": "America/Los_Angeles",
        "coordinates": {
          "latitude": 77.1025,
          "longitude": 28.7041
        }
      },
      "coordinates": {
        "latitude": 77.1025,
        "longitude": 28.7041
      }
    },
    "allowedBookingTypes": [
      "AIR"
    ],
    "bookingGuidelines": [
      {
        "numGuestsAllowed": 1,
        "airBookingGuideLine": {
          "allowedAirports": [
            {
              "airportCode": "WRA",
              "airportName": "Warder Airport",
              "cityName": "Werder",
              "countryName": "Ethiopia",
              "countryCode": "ET",
              "zoneName": "Africa/Addis_Ababa",
              "stateCode": "CA"
            }
          ],
          "arrivalBookingWindow": {
            "startDateTime": {
              "iso8601": "2017-07-21T17:32"
            },
            "endDateTime": {
              "iso8601": "2017-07-21T17:32"
            }
          },
          "departureBookingWindow": {
            "startDateTime": {
              "iso8601": "2017-07-21T17:32"
            },
            "endDateTime": {
              "iso8601": "2017-07-21T17:32"
            }
          },
          "allowedFlightGuidelines": [
            {
              "allowedFlightType": "ROUND_TRIP",
              "numberOfLegs": 2
            }
          ]
        }
      }
    ],
    "customFieldResponses": [
      {
        "customFieldId": "f49d00fe-1eda-4304-ba79-a980f565281d",
        "responseItems": [
          {
            "response": "Leisure travel",
            "additionalInput": "20"
          }
        ],
        "travelerAccess": "HIDDEN"
      }
    ],
    "paymentMappings": [
      {
        "id": "f49d00fe-1eda-4304-ba79-a980f565281d",
        "accessTypeAttributes": {
          "travelTypeFilter": {
            "travelTypes": [
              {
                "travelType": "AIR",
                "isRequired": true,
                "allowPostPaidBookings": false,
                "metadata": {
                  "vendors": []
                }
              }
            ]
          }
        }
      }
    ],
    "companyId": {
      "id": "f49d00fe-1eda-4304-ba79-a980f565281d"
    },
    "internalNotes": "Use travelers default as payment method.",
    "referenceUsers": [
      {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      }
    ],
    "travelerTypes": [
      "EMPLOYEE"
    ],
    "policyId": "f7b3b3b3-7b3b-4b3b-8b3b-3b3b3b3b3b3b",
    "bookingStyle": "SELF_SERVE",
    "externalId": "qwert123",
    "allowTravelersPolicy": "ALLOWED",
    "emailPreferences": {
      "bucketTypes": [
        "BOOKING_CONFIRMATIONS"
      ],
      "isEnabled": false,
      "toEmails": [
        "example@email.com"
      ],
      "ccEmails": [
        "example@email.com"
      ],
      "bccEmails": [
        "example@email.com"
      ]
    }
  }'

Responses

Bodyapplication/json

idstring

Response

application/json

{
  "id": "string"
}

Get event template

Request

This endpoint gets event template details for a given template ID.

Path

templateIdstringrequired

Template ID

Example: 6926658168

curl -i -X GET \
  https://apis.spotnana.com/v2/event-templates/6926658168 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Bodyapplication/json

eventTemplateobject(EventTemplate)

The event template object.

Response

application/json

{
  "eventTemplate": {
    "id": "string",
    "name": "string",
    "description": "string",
    "location": { … },
    "paymentSources": [ … ],
    "companyId": { … },
    "customFieldResponses": [ … ],
    "group": { … },
    "externalId": "qwert123",
    "policyId": "f7b3b3b3-7b3b-4b3b-8b3b-3b3b3b3b3b3b"
  }
}

Delete an event template

Request

This endpoint delete an event template.

Path

templateIdstringrequired

Template ID

Example: 6926658168

curl -i -X DELETE \
  https://apis.spotnana.com/v2/event-templates/6926658168 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Response

No content

Update template's basic information

Request

This endpoint allows updating basic template information.

Path

templateIdstringrequired

Template ID

Example: 6926658168

Bodyapplication/json

namestring

Name of the event template

descriptionstring

Description of the event

internalNotesstring

Internal notes of the event

referenceUsersArray of objects(UserId)

Event group reference user ids

locationobject(EventLocation)

Location for an event

travelerTypesArray of strings(Persona)non-empty

Allowed traveler types for the event

Items Enum"UNKNOWN_PERSONA""EMPLOYEE""GUEST""PERSONAL""RELATIVE""ADHOC"

Example: ["EMPLOYEE"]

bookingStylestring(EventBookingStyle)

Whether the event bookings will be self served by the traveler or would be arranged by an agent for the traveler.

Enum"SELF_SERVE""AGENT_MANAGED"

policyIdstring(uuid)

Policy associated with the event.

Example: "f7b3b3b3-7b3b-4b3b-8b3b-3b3b3b3b3b3b"

allowTravelersPolicystring(AllowTravelersPolicy)

Apply travelers policy when it is less restrictive.

Enum"ALLOWED""NOT_ALLOWED"

emailPreferencesobject(BucketEmailPreferences)

Email communication preferences based on bucket types.

curl -i -X POST \
  https://apis.spotnana.com/v2/event-templates/6926658168/edit-basic-info \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "description": "string",
    "internalNotes": "string",
    "referenceUsers": [
      {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      }
    ],
    "location": {
      "address": {
        "addressLines": [
          "Golden Gate Bridge"
        ],
        "administrativeArea": "CA",
        "administrativeAreaName": "California",
        "description": "San Francisco Home",
        "isDefault": true,
        "languageCode": "en",
        "locality": "San Francisco",
        "locationCode": "LAX",
        "organization": "Spotnana",
        "postalCode": "94130",
        "continentCode": "AF",
        "recipients": [
          "string"
        ],
        "regionCode": "US",
        "regionName": "America",
        "revision": 1,
        "sortingCode": "Jamaica",
        "sublocality": "string",
        "timezone": "America/Los_Angeles",
        "coordinates": {
          "latitude": 77.1025,
          "longitude": 28.7041
        }
      },
      "coordinates": {
        "latitude": 77.1025,
        "longitude": 28.7041
      }
    },
    "travelerTypes": [
      "EMPLOYEE"
    ],
    "bookingStyle": "SELF_SERVE",
    "policyId": "f7b3b3b3-7b3b-4b3b-8b3b-3b3b3b3b3b3b",
    "allowTravelersPolicy": "ALLOWED",
    "emailPreferences": {
      "bucketTypes": [
        "BOOKING_CONFIRMATIONS"
      ],
      "isEnabled": false,
      "toEmails": [
        "example@email.com"
      ],
      "ccEmails": [
        "example@email.com"
      ],
      "bccEmails": [
        "example@email.com"
      ]
    }
  }'

Responses

Response

No content

Update template booking guidelines

Request

This endpoint updates the booking guidelines for a template.

Path

templateIdstringrequired

Template ID

Example: 6926658168

Bodyapplication/json

A list of booking guideline for the event.

allowedBookingTypesArray of strings(EventAllowedBookingType)

Allowed booking types for the event template

Items Enum"AIR""HOTEL""CAR""RAIL"

paymentMappingsArray of objects(PaymentAccessMapping)

Mappings i.e. access level, travel type information etc.

curl -i -X POST \
  https://apis.spotnana.com/v2/event-templates/6926658168/edit-booking-guidelines \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "bookingGuidelines": [
      {
        "numGuestsAllowed": 1,
        "airBookingGuideLine": {
          "allowedAirports": [
            {
              "airportCode": "WRA",
              "airportName": "Warder Airport",
              "cityName": "Werder",
              "countryName": "Ethiopia",
              "countryCode": "ET",
              "zoneName": "Africa/Addis_Ababa",
              "stateCode": "CA"
            }
          ],
          "arrivalBookingWindow": {
            "startDateTime": {
              "iso8601": "2017-07-21T17:32"
            },
            "endDateTime": {
              "iso8601": "2017-07-21T17:32"
            }
          },
          "departureBookingWindow": {
            "startDateTime": {
              "iso8601": "2017-07-21T17:32"
            },
            "endDateTime": {
              "iso8601": "2017-07-21T17:32"
            }
          },
          "allowedFlightGuidelines": [
            {
              "allowedFlightType": "ROUND_TRIP",
              "numberOfLegs": 2
            }
          ]
        }
      }
    ],
    "allowedBookingTypes": [
      "AIR"
    ],
    "paymentMappings": [
      {
        "id": "f49d00fe-1eda-4304-ba79-a980f565281d",
        "accessTypeAttributes": {
          "travelTypeFilter": {
            "travelTypes": [
              {
                "travelType": "AIR",
                "isRequired": true,
                "allowPostPaidBookings": false,
                "metadata": {
                  "vendors": []
                }
              }
            ]
          }
        }
      }
    ]
  }'

Responses

Response

No content

Update template's custom field responses.

Request

This endpoint updates the template's custom field responses.

Path

templateIdstringrequired

Template ID

Example: 6926658168

Bodyapplication/json

customFieldResponsesArray of objects(CustomFieldResponse)required

Preselected custom field responses for the event template.

customFieldResponses[].customFieldIdstring(uuid)required

The unique identifier for the custom field.

Example: "f49d00fe-1eda-4304-ba79-a980f565281d"

customFieldResponses[].responseItemsArray of objects(CustomFieldResponseItem)

Responses selected by the event coordinator.

customFieldResponses[].travelerAccessstring(CustomFieldTravelerAccess)required

Traveler access for the given custom field.

Enum"HIDDEN""READ_ACCESS""WRITE_ACCESS"

curl -i -X PUT \
  https://apis.spotnana.com/v2/event-templates/6926658168/custom-field-responses \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "customFieldResponses": [
      {
        "customFieldId": "f49d00fe-1eda-4304-ba79-a980f565281d",
        "responseItems": [
          {
            "response": "Leisure travel",
            "additionalInput": "20"
          }
        ],
        "travelerAccess": "HIDDEN"
      }
    ]
  }'

Responses

Response

No content

List event templates

Request

This endpoint lists event templates.

Bodyapplication/json

filtersArray of EventCompanyFilterWrapper (object) or EventNameFilterWrapper (object)(EventTemplateFilter)

List events filters

offsetinteger>= 0

Indicates from where in the list of events the server should start.

Default 0

Example: 2

limitinteger<= 100

Maximum number of results to be fetched for the query.

Default 25

Example: 2

curl -i -X POST \
  https://apis.spotnana.com/v2/event-templates/list \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "filters": [
      {
        "companyFilter": {
          "companyId": {
            "id": "f49d00fe-1eda-4304-ba79-a980f565281d"
          }
        }
      }
    ],
    "offset": 2,
    "limit": 2
  }'

Responses

Bodyapplication/json

eventTemplatesArray of objects(EventTemplate)

List of event templates

paginationParamsobject(OffsetBasedPaginationResponseParams)

Pagination parameters for response.

Response

application/json

{
  "eventTemplates": [
    { … }
  ],
  "paginationParams": {
    "totalNumResults": 0
  }
}

Get template by external ID

Request

Get template details using the template's externalId. External IDs are unique identifiers which can be set based on the company's preference.

Query

externalIdstringrequired

External ID

Example: externalId=6926658168

companyIdstring(uuid)required

Company ID

Example: companyId=f49d00fe-1eda-4304-ba79-a980f565281d

curl -i -X GET \
  'https://apis.spotnana.com/v2/event-templates/read-by-external-id?companyId=f49d00fe-1eda-4304-ba79-a980f565281d&externalId=6926658168' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Bodyapplication/json

eventTemplateobject(EventTemplate)

The event template object.

Response

application/json

{
  "eventTemplate": {
    "id": "string",
    "name": "string",
    "description": "string",
    "location": { … },
    "paymentSources": [ … ],
    "companyId": { … },
    "customFieldResponses": [ … ],
    "group": { … },
    "externalId": "qwert123",
    "policyId": "f7b3b3b3-7b3b-4b3b-8b3b-3b3b3b3b3b3b"
  }
}

Template API (v2)

Event Templates

Create an event template

RequestExpand all

Responses

Get event template

Request

Responses

Delete an event template

Request

Responses

Update template's basic information

RequestExpand all

Responses

Update template booking guidelines

RequestExpand all

Responses

Update template's custom field responses.

RequestExpand all

Responses

List event templates

RequestExpand all

Responses

Get template by external ID

Request

Responses

Request

Request

Request

Request

Request