Создать событие

POST /v1/events

Группа: События

События создаются только от имени организаций. У пользователя, вызывающего этот метод, должны быть права на администрированое данной организации.

Описание создаваемого события

CreateEvent ⇊
organization: OrganizationInclude ⇊
id: integer

Номер организации в Таймпаде

subdomain: string

URL-идентификатор организации в Таймпаде (***.timepad.ru)

Организация, проводящая событие

starts_at: string (date-time)

Дата начала события

ends_at: string (date-time)

Дата окончания события

name: string

Название события

description_short: string

Краткое описание/подзаголовок события

description_html: string

Полное описание с html-тегами

categories: CategoryInclude[]

Список категорий, в которые входит событие

CategoryInclude ⇊
id: integer

Номер категории в Таймпаде

name: string

Название категории в Таймпаде

location: LocationInclude ⇊
city: string

Город проведения события

address: string

Адрес проведения события

Место проведения события

poster_image_url: string

URL картинки события

properties: string[]

Список настроек события (например, мультианкета)

string
custom: object

Объект с дополнительными полями, специфичными для данной организации

questions: QuestionInclude[]

Список вопросов в анкете регистрации

QuestionInclude ⇊
field_id: string

Уникальный текстовый идентификатор вопроса

is_mandatory: boolean

Является ли ответ на вопрос обязательным

status: string

Статус вопроса

name: string

Текст вопроса

comment: string

Подсказка под вопросом

type: string

Тип вопроса

possible_answers: string[]

Список ответов на вопрос

string
access_status: string

Статус доступа к событию

age_limit: string

Возрастное ограничение события

tickets_limit: integer

Максимальное количество человек, которые могут посетить событие. При достижении этого количества регистрация на событие закроется, даже если будут открытыми категории регистрации. Поставьте 0, чтобы снять ограничение. Учитывается количество как оплаченных, так и забронированных билетов.

ticket_types: TicketTypeRequest[]

Список видов билетов

TicketTypeRequest ⇊
id: integer

Номер существующего типа билета

price: integer

Цена существующего типа билета

status: string

Статус типа билета

name: string

Название типа билета

description: string

Описание типа билета

sale_starts_at: string (date-time)

Дата начала продажи типа билета

sale_ends_at: string (date-time)

Дата окончания продажи типа билета

send_personal_links: boolean

Категория билетов с отправкой персональных ссылок

limit: boolean

Ограничение на количество билетов этого типа

personal_links: string[]

Список персональных ссылок для билетов

string
personal_link_title: boolean

Заголовок персональной ссылки (Например: Ваша ссылка на онлайн-трансляцию)

is_sending_free_tickets: boolean

Отправлять билеты на бесплатные регистрации

reservation_period: integer

Срок брони билета в часах. Нулевое значение соответствует неограниченному сроку

Созданное событие

EventResponse ⇊
id: integer

Уникальный номер события

created_at: string (date)

Дата создания события

starts_at: string (date)

Дата начала события

ends_at: string (date)

Дата конца события

name: string

Название события

description_short: string

Короткое описание события или подзаголовок

description_html: string

Полное описание события

url: string

Адрес события в timepad

poster_image: ImageResponse ⇊
default_url: string

Картинка стандартного размера

uploadcare_url: string

Адрес картинки на uploadcare, к которому можно прибавлять запросы в формате uploadcare

Картинка события

ad_partner_percent: integer

Процент, который получают партнёры за продажу билета на это событие

locale: string

Язык события по умолчанию

location: LocationResponse ⇊
country: string

Название страны

city: string

Название города

address: string

Адрес проведения события

coordinates: number[]

Широта и долгота для карт

number

Место проведения события

organization: OrganizationResponse ⇊
id: integer

Номер организации

name: string

Название организации

description_html: string

Описание организации

url: string

URL организации на сайте

logo_image: ImageResponse ⇊
default_url: string

Картинка стандартного размера

uploadcare_url: string

Адрес картинки на uploadcare, к которому можно прибавлять запросы в формате uploadcare

Логотип

subdomain: string

URL-идентификатор организации в Таймпаде (***.timepad.ru)

permissions: string[]

Настройки доступов для организаций

string

Организация, проводящая событие

categories: CategoryResponse[]

Категории события

CategoryResponse ⇊
id: integer

Уникальный номер категории

name: string

Название категории

tickets_limit: integer

Максимальное количество человек, которые могут посетить событие

ticket_types: TicketTypeResponse[]

Доступные типы билетов

TicketTypeResponse ⇊
id: integer

Уникальный номер типа билета

name: string

Название типа билета

description: string

Описание типа билета

buy_amount_min: number

Минимальное количество билетов в одной покупке

buy_amount_max: number

Максимальное количество билетов в одной покупке

price: number

Цена билета

is_promocode_locked: boolean

Закрыт ли этот тип билета введённым промокодом

remaining: integer

Сколько билетов осталось

sale_ends_at: string (date)

Дата окончания продажи типа билета

sale_starts_at: string (date)

Дата начала продажи типа билета

public_key: string

Публичный ключ для расшифровки QR-кода билета этого типа

is_active: boolean

Активность типа билета

ad_partner_profit: number

Партнёрская прибыль

send_personal_links: boolean

Отправка персональных сссылок

sold: number

Количество проданных билетов

attended: number

Количество посетивших людей

limit: number

Ограничение на количество билетов в этом типе билета

status: string

Статус типа билета

personal_links: string[]

Персональные ссылки. Доступно только при указании токена со разрешением view_private_events

string
questions: QuestionResponse[]

Вопросы, задающиеся при регистрации

QuestionResponse ⇊
field_id: integer

Уникальный текстовый идентификатор вопроса

name: string

Текст вопроса

comment: string

Подсказка под вопросом

type: string , x ∈ { text , multiline_text , select_one , select_many , upload , agree }

Тип вопроса

possible_answers: AnswerResponse[]

Список предлагаемых ответов (если вопрос предполагает такой список)

AnswerResponse ⇊
id: integer

Уникальный номер ответа

name: string

Текст ответа

is_mandatory: boolean

Является ли ответ на вопрос обязательным

is_for_every_visitor: boolean

Выводить вопрос отдельно для каждого купленного билета

meta: object

Дополнительные данные

age_limit: string

Возрастное ограничение события

widgets: WidgetResponse[]

Виджеты, доступные для события

WidgetResponse ⇊
code_html: string

Код вставки виджета в сайт

properties: string[]

Список особенностей события

string
moderation_status: string

Статус модерации

access_status: string

Статус доступа к событию

registration_data: RegistrationDataResponse ⇊
price_max: number

Цена самого дорогого билета

price_min: number

Цена самого дешёвого билета

sale_ends_at: string (date)

Дата окончания продажи последней категории билета

tickets_total: integer

Количество забронированных, проданных и бесплатных билетов

tickets_limit: integer

Максимальное количество доступных билетов, независимо от типа билета

is_registration_open: boolean

Открыта ли регистрация

Обобщённые данные о билетах

is_sending_free_tickets: boolean

Отправлять билеты на бесплатные регистрации

personal_link_title: string

Заголовок персональной ссылки. Доступно только при указании токена со разрешением view_private_events

reservation_period: integer

Срок брони билета в часах. Нулевое значение соответствует неограниченному сроку
add_events