Add a date to an event

Minimum role: ADMIN. Active workspace via the X-Workspace-Id header.

POST/events/{id}/dates

Authorization

AuthorizationAPI key · headerrequired

API key prefixed with Bearer . Alternative: the x-api-key header with the raw key. Available scopes: read and write (see /.well-known/oauth-protected-resource).

x-api-keyAPI key · headerrequired

Raw API key (without Bearer ), alternative to Authorization.

Path parameters

idstringrequired

Header parameters

X-Workspace-Idstring

Active workspace to operate on. Optional: when omitted, the default workspace of the user who owns the key is used (pickActiveOrg).

Request body

requiredapplication/json

labelstring | null

Show properties

Any of:

string

string

null

null

startsAtstring<date-time>required

matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

endsAtstring<date-time> | null

Show properties

Any of:

string<date-time>

string<date-time>

null

null

doorsOpenAtstring<date-time> | null

Show properties

Any of:

string<date-time>

string<date-time>

null

null

timezonestringrequired

min length 1 · default: "America/Bogota"

venueIdstring | null

Show properties

Any of:

string

string

null

null

streamTypestringrequired

default: "PRESENCIAL"

Allowed:PRESENCIALONLINEHIBRIDO

Responses

201

dataEventDaterequired

Show properties

idstringrequired

eventIdstringrequired

labelstring | nullrequired

Show properties

Any of:

string

string

null

null

startsAtstringrequired

endsAtstring | nullrequired

Show properties

Any of:

string

string

null

null

doorsOpenAtstring | nullrequired

Show properties

Any of:

string

string

null

null

timezonestringrequired

venueIdstring | nullrequired

Show properties

Any of:

string

string

null

null

venueVenue | nullrequired

Show properties

Any of:

Venue

idstringrequired

namestringrequired

slugstringrequired

addressstringrequired

citystringrequired

countrystringrequired

latitudenumber | nullrequired

Show properties

Any of:

number

number

null

null

longitudenumber | nullrequired

Show properties

Any of:

number

number

null

null

capacityinteger | nullrequired

Show properties

Any of:

integer

integer

null

null

googlePlaceIdstring | nullrequired

Show properties

Any of:

string

string

null

null

portalVisiblebooleanrequired

organizationIdstring | nullrequired

Show properties

Any of:

string

string

null

null

seatsioChartKeystring | nullrequired

Show properties

Any of:

string

string

null

null

createdAtstringrequired

null

null

ticketTypesTicketType[]required

default: []

Show properties

Array of TicketType

idstringrequired

eventDateIdstringrequired

namestringrequired

descriptionstring | nullrequired

Show properties

Any of:

string

string

null

null

pricenumberrequired

currencystringrequired

capacityintegerrequired

min -9007199254740991 · max 9007199254740991

soldintegerrequired

min -9007199254740991 · max 9007199254740991

availableintegerrequired

min -9007199254740991 · max 9007199254740991

soldOutbooleanrequired

maxPerOrderintegerrequired

min -9007199254740991 · max 9007199254740991

saleStartsAtstring | nullrequired

Show properties

Any of:

string

string

null

null

saleEndsAtstring | nullrequired

Show properties

Any of:

string

string

null

null

isVisiblebooleanrequired

organizerAbsorbsFeebooleanrequired

buyerServiceFeenumberrequired

seatingSurchargenumberrequired

ivanumberrequired

buyerTotalnumberrequired

seatsioCategoryKeystring | nullrequired

Show properties

Any of:

string

string

null

null

priceStagesTicketPriceStage[]

Price stages preceding the final price, ordered by sortOrder. [] = fixed price. Absent if the response does not include them.

Show properties

Array of TicketPriceStage

idstringrequired

namestringrequired

pricenumberrequired

sortOrderintegerrequired

min -9007199254740991 · max 9007199254740991

endsAtstring | nullrequired

Closes once this date passes (ISO 8601). null = no date cutoff.

Show properties

Any of:

string

string

null

null

quantityinteger | nullrequired

Tickets at this price. The cutoff is CUMULATIVE across the ticket type: the stage closes when sold + reserved reaches the sum of quantity for this stage and all previous ones. null = no quantity cutoff.

Show properties

Any of:

integer

integer

null

null

isCurrentbooleanrequired

true for the stage currently in effect (the first one still open). If none is, the ticket type's price applies.

currentPricenumber

CURRENT base price per unit (the open stage, or price if none). Present alongside priceStages.

createdAtstringrequired

seatsioEventKeystring | nullrequired

seats.io event key. Read-only: issued by automatic provisioning; writing it by hand orphans seats already sold.

Show properties

Any of:

string

string

null

null

statusstringrequired

Allowed:DRAFTPUBLISHEDSOLD_OUTCANCELLEDCOMPLETED

streamTypestringrequired

createdAtstringrequired

401

Missing or invalid credential.

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

retryablebooleanrequired

detailsany

403

Insufficient role or resource not accessible.

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

retryablebooleanrequired

detailsany

404

Resource does not exist or is out of scope.

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

retryablebooleanrequired

detailsany

422

Request body/parameter validation failed.

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

retryablebooleanrequired

detailsany

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

API keyRemember on this deviceInclude my values in samples

Parameters

idpath*X-Workspace-IdheaderActive workspace to operate on. Optional: when omitted, the default workspace of the user who owns the key is used (pickActiveOrg).

Bodyapplication/json

labelstringstartsAtstring*endsAtstringdoorsOpenAtstringtimezonestring*venueIdstringstreamTypestring*

Request

curl -X POST 'https://admin.appfreeticket.com/api/v1/events/string/dates' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "label": "string",
  "startsAt": "2019-08-24T14:15:22Z",
  "endsAt": "2019-08-24T14:15:22Z",
  "doorsOpenAt": "2019-08-24T14:15:22Z",
  "timezone": "America/Bogota",
  "venueId": "string",
  "streamType": "PRESENCIAL"
}'

const response = await fetch("https://admin.appfreeticket.com/api/v1/events/string/dates", {
  method: "POST",
  headers: {
    "Authorization": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: "{\n  \"label\": \"string\",\n  \"startsAt\": \"2019-08-24T14:15:22Z\",\n  \"endsAt\": \"2019-08-24T14:15:22Z\",\n  \"doorsOpenAt\": \"2019-08-24T14:15:22Z\",\n  \"timezone\": \"America/Bogota\",\n  \"venueId\": \"string\",\n  \"streamType\": \"PRESENCIAL\"\n}"
});

import requests

response = requests.post(
    "https://admin.appfreeticket.com/api/v1/events/string/dates",
    headers={
        "Authorization": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    data="{\n  \"label\": \"string\",\n  \"startsAt\": \"2019-08-24T14:15:22Z\",\n  \"endsAt\": \"2019-08-24T14:15:22Z\",\n  \"doorsOpenAt\": \"2019-08-24T14:15:22Z\",\n  \"timezone\": \"America/Bogota\",\n  \"venueId\": \"string\",\n  \"streamType\": \"PRESENCIAL\"\n}",
)

Response

{
  "data": {
    "id": "string",
    "eventId": "string",
    "label": "string",
    "startsAt": "string",
    "endsAt": "string",
    "doorsOpenAt": "string",
    "timezone": "string",
    "venueId": "string",
    "venue": {
      "id": "string",
      "name": "string",
      "slug": "string",
      "address": "string",
      "city": "string",
      "country": "string",
      "latitude": 0,
      "longitude": 0,
      "capacity": -9007199254740991,
      "googlePlaceId": "string",
      "portalVisible": true,
      "organizationId": "string",
      "seatsioChartKey": "string",
      "createdAt": "string"
    },
    "ticketTypes": [],
    "seatsioEventKey": "string",
    "status": "DRAFT",
    "streamType": "string",
    "createdAt": "string"
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true,
    "details": null
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true,
    "details": null
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true,
    "details": null
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true,
    "details": null
  }
}