Create or upsert an organizer

POST

/v1/organizers

• Production API

Creates a new organizer or upserts an existing one. The companyId is always forced from the authenticated user’s context — any companyId supplied in the request body is stripped. Supply an id to upsert; omit id to create.

Authorizations

• bearerAuth

Request Body ^required

object

organizer

required

Input schema for creating or upserting an organizer. companyId is always forced from the authenticated user’s context and cannot be supplied by the client.

object

id

Organizer ID — provide when upserting an existing organizer; omit to create a new one

string

Example

org_abc123

slug

URL-friendly slug

string

Example

acme-events

companyId

Forced from the authenticated user’s context; any value supplied by the client is stripped

string

bio

Short biography

string

description

Detailed description in multiple formats (multipart text)

object

summary

Brief summary in multiple formats (multipart text)

object

followers

Number of followers

integer

0

headline

Headline or tagline

string

logo

Logo photo with multiple resolutions

object

name

required

Display name

string

Example

Acme Events

links

Social media and website links

Array<object>

object

category

string

Allowed values: facebook twitter instagram linkedin youtube tiktok website

Example

instagram

url

string

Example

https://instagram.com/acmeevents

priority

integer

default: 10

isPrimary

boolean

appearance

Custom appearance and branding configuration

object

config

Additional configuration data

object

settings

Organizer settings

object

confirmationAssetId

string

Example

{
  "organizer": {
    "name": "Acme Events",
    "slug": "acme-events",
    "bio": "We produce world-class live events.",
    "headline": "Your favourite event producers",
    "links": [
      {
        "category": "instagram",
        "url": "https://instagram.com/acmeevents",
        "isPrimary": true
      }
    ]
  }
}

Responses

200

The created or upserted organizer

object

status

string

Example

ok

data

object

organizer

An event organizer / organization profile

object

id

required

Unique identifier for the organizer

string

Example

org_abc123

slug

URL-friendly slug

string

Example

acme-events

companyId

required

ID of the company this organizer belongs to

string

Example

company_xyz789

bio

Short biography

string

Example

We produce world-class live events.

description

Detailed description in multiple formats (multipart text)

object

summary

Brief summary in multiple formats (multipart text)

object

followers

Number of followers

integer

0

Example

1500

headline

Headline or tagline

string

Example

Your favourite event producers

logo

Logo photo with multiple resolutions

object

name

required

Display name

string

Example

Acme Events

links

Social media and website links

Array<object>

object

category

Link category

string

Allowed values: facebook twitter instagram linkedin youtube tiktok website

Example

instagram

url

Full URL

string

Example

https://instagram.com/acmeevents

priority

Display order priority (lower = higher priority)

integer

default: 10

isPrimary

Whether this is the primary link

boolean

appearance

Custom appearance and branding configuration

object

config

Additional configuration data

object

settings

Organizer settings

object

confirmationAssetId

Asset ID used for order confirmation

string

400

Validation failed — request body is missing or malformed

object

status

string

Example

error

message

string

Example

An error occurred

error

string

401

Unauthorized

object

status

string

Example

error

message

string

Example

An error occurred

error

string

500

Internal server error

object

status

string

Example

error

message

string

Example

An error occurred

error

string