Event makers

An event maker is an organiser on Place2Book. It owns events, bank accounts and newsletter sign-ups. Every other resource in the API is nested under an event maker.

The event maker object

Field	Type	Description
`id`	`integer`	Unique identifier.
`name`	`string`	Display name shown to buyers.
`cvr`	`string`	Danish CVR number (8 digits).
`company_name`	`string`	Official company name.
`support_email`	`string`	Email address buyers can contact.
`mute`	`boolean`	When `true`, no emails are sent on behalf of the event maker.
`links.events`	`string`	URL of the event maker’s events.
`links.bank_accounts`	`string`	URL of the event maker’s bank accounts.
`address`	`object`	Postal address. Left out if the event maker has no address.
`address.address1`	`string`	Street address.
`address.postal_code`	`string`	Postal code.
`address.city`	`string`	City.
`address.phone`	`string`	Phone number.
`address.country`	`string`	ISO 3166-1 alpha-2 country code.

{
  "id": 1234567,
  "cvr": "28888880",
  "name": "Eventbureauet",
  "company_name": "Place2Book ApS",
  "support_email": "support@eventbureauet.dk",
  "mute": false,
  "links": {
    "events": "https://api.place2book.com/event_makers/1234567/events",
    "bank_accounts": "https://api.place2book.com/event_makers/1234567/bank_accounts"
  },
  "address": {
    "address1": "Nørrelundvej 5",
    "postal_code": "2730",
    "city": "Herlev",
    "phone": "+4570232550",
    "country": "DK"
  }
}

List event makers

Returns every event maker your token can access.

GET/event_makers

Response200 OK

[
  {
    "id": 1234567,
    "cvr": "28888880",
    "name": "Eventbureauet",
    "company_name": "Place2Book ApS",
    "support_email": "support@eventbureauet.dk",
    "mute": false,
    "links": {
      "events": "https://api.place2book.com/event_makers/1234567/events",
      "bank_accounts": "https://api.place2book.com/event_makers/1234567/bank_accounts"
    },
    "address": {
      "address1": "Nørrelundvej 5",
      "postal_code": "2730",
      "city": "Herlev",
      "phone": "+4570232550",
      "country": "DK"
    }
  }
]

Get an event maker

GET/event_makers/:event_maker_id

Response200 OK

{
  "id": 1234567,
  "cvr": "28888880",
  "name": "Eventbureauet",
  "company_name": "Place2Book ApS",
  "support_email": "support@eventbureauet.dk",
  "mute": false,
  "links": {
    "events": "https://api.place2book.com/event_makers/1234567/events",
    "bank_accounts": "https://api.place2book.com/event_makers/1234567/bank_accounts"
  },
  "address": {
    "address1": "Nørrelundvej 5",
    "postal_code": "2730",
    "city": "Herlev",
    "phone": "+4570232550",
    "country": "DK"
  }
}

Possible errors404 Not Found

Create an event maker

Creates an event maker and gives your API user access to it.

POST/event_makers

Parameters

Parameter	Type	Description
`name`	`string`	required Display name, 2–60 characters.
`cvr`	`string`	Danish CVR number, exactly 8 digits.
`company_name`	`string`	Official company name, 2–60 characters.
`support_email`	`string`	Email address buyers can contact.
`address`	`object`	Postal address.
`address.address1`	`string`	Street address.
`address.address2`	`string`	Extra address line.
`address.postal_code`	`string`	Postal code.
`address.city`	`string`	City.
`address.phone`	`string`	Phone number.
`address.country`	`string`	ISO 3166-1 alpha-2 country code, e.g. `DK`.

Request body

{
  "event_maker": {
    "name": "Eventbureauet",
    "cvr": "28888880",
    "company_name": "Place2Book ApS",
    "support_email": "support@eventbureauet.dk",
    "address": {
      "address1": "Nørrelundvej 5",
      "address2": "",
      "postal_code": "2730",
      "city": "Herlev",
      "phone": "+4570232550",
      "country": "DK"
    }
  }
}

Response201 Created

Location: https://api.place2book.com/event_makers/1234567

{
  "id": 1234567,
  "cvr": "28888880",
  "name": "Eventbureauet",
  "company_name": "Place2Book ApS",
  "support_email": "support@eventbureauet.dk",
  "mute": false,
  "links": {
    "events": "https://api.place2book.com/event_makers/1234567/events",
    "bank_accounts": "https://api.place2book.com/event_makers/1234567/bank_accounts"
  },
  "address": {
    "address1": "Nørrelundvej 5",
    "postal_code": "2730",
    "city": "Herlev",
    "phone": "+4570232550",
    "country": "DK"
  }
}

Possible errors422 Unprocessable Content

Update an event maker

PUT/event_makers/:event_maker_id

Takes the same parameters as create.

Updates replace every field name, cvr, company_name and support_email are all set from the request. A field you leave out is cleared, so always send the complete object. If you leave out address, the current address is kept.

Response200 OK

{
  "id": 1234567,
  "cvr": "28888880",
  "name": "Eventbureauet",
  "company_name": "Place2Book ApS",
  "support_email": "support@eventbureauet.dk",
  "mute": false,
  "links": {
    "events": "https://api.place2book.com/event_makers/1234567/events",
    "bank_accounts": "https://api.place2book.com/event_makers/1234567/bank_accounts"
  },
  "address": {
    "address1": "Nørrelundvej 5",
    "postal_code": "2730",
    "city": "Herlev",
    "phone": "+4570232550",
    "country": "DK"
  }
}

Possible errors404 Not Found 422 Unprocessable Content