Create a campaign

post

https://example.com/app-api/campaign

Create the campaign by its external ID. Flights that will be created on this campaign will have the agency or intermediator commission as well discounts applied to them.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

name

string

required

Corresponds with the field "Kampagne"

status

string

enum

required

Defaults to booking

Corresponds with the field "Status"

Allowed:

bookingDate

date

required

Corresponds with the field "Buchungsdatum"

campaignTypeId

integer

Corresponds with the field "Kampagnentyp"

campaignTypeReference

string

Corresponds with the field "Kampagnentyp Referenz"

customer

object | null

required

This entity represents either a customer, agency, intermediator or publisher, either the external ID or the external CRM ID or the goTom ID can be set

intermediator

object | null

This entity represents either a customer, agency, intermediator or publisher, either the external ID or the external CRM ID or the goTom ID can be set

agency

object | null

This entity represents either a customer, agency, intermediator or publisher, either the external ID or the external CRM ID or the goTom ID can be set

note

string | null

Corresponds with the Field "Bemerkungen"

noteInternal

string

Corresponds with the Field "Interne Bemerkungen"

noteReservation

string

Corresponds with the Field "Reservationsabklärung"

pdfInvoiceWithAttachment

boolean

Defaults to true

Corresponds to the "Dokumente" field. If true, the invoice will be created with an appendix e.g. the Order Confirmation; if false, it will be created without one, as default it would be true.

billingType

integer

enum

Corresponds with the field "Billing type" / "Abrechnungsart" on the "Invoicing" / "Billing type" view of the campaign. Use this value only if you want to explicitly define the billing type of the campaign. You can safely omit this value to let goTom apply the rules for finding the right billing type for this campaign. Billing type possible values and their meaning:

0 - Custom - The user must explicitly set up the invoices and assign flights
1 - End / Nach Ablauf - All flights are automatically assigned to one invoice
2 - Monthly to daily value / Monatlich nach Tageswert - Automatic assignment on a monthly basis, distributed by time
3 - Monthly to delivery value / Monatlich nach Lieferwert - Automatic assignment on a monthly basis, distributed by delivery value

Please note, that your instance may not support all values. If your instance does not have an ad-server integration the value for "Monthly to delivery value" can't be used. If you use a value that is not supported by your instance, you will get an API error (code 7e44e734-3535-4172-8e32-0efa8b33a5e0) with the list of the possible values for your instance. If the campaign has at least one invoice that has already been invoiced it is also not possible to change this value to something different. If this is the case you will get the API error code 43452cb6-8850-4036-b1f5-971c8328e10b and none of the updates in the payload will be applied.

Allowed:

salesSupportId

integer

Correspons with the field "Innendienst". Only salesSupportId or salesSupportEmail should be provided.

salesSupportEmail

string

Correspons with the field "Innendienst". Only salesSupportId or salesSupportEmail should be provided.

salesId

integer

Corresponds with the field "Verkauf". Only salesId or salesEmail should be provided.

salesEmail

string

Corresponds with the field "Verkauf". Only salesId or salesEmail should be provided.

externalId

string

required

currency

string

Corresponds with the field "Währung". Currency of the campaign (the instance default is used if none is supplied)

Responses

201

Campaign has been created

500If your request broke our code. Send us your request-document to reproduce the error and we'll fix it.