Promoters

Create a new promoter

Changed on

Create a new promoter brand within a team

post/promoters

Request

  • Base URL: https://api.session.services
  • URL: https://api.session.services/promoters
  • Auth: API key in header x-tenant-id

Request body

namestring required

Display name of the promoter organization. Must be between 3 and 30 characters

slugstring

URL-friendly slug for the promoter organization. If not provided, will be automatically generated from the name. Must be unique and between 3 and 30 characters

teamIdstring required

ID of the team that will own this promoter. User must be a member of this team.

descriptionstring required

Detailed description of the promoter organization and their events

metadataobject

Flexible key-value metadata storage for custom configuration. Similar to Stripe's metadata API. Maximum 50 keys, key names up to 40 characters, values up to 500 characters.

locationIdstring

ID of an existing location. Either locationId or googlePlaceId must be provided.

googlePlaceIdstring

Google Place ID to create a new location from. Either locationId or googlePlaceId must be provided.

Example request

{
  "name": "Session Services",
  "slug": "session-services",
  "teamId": "tem_01jqpjksnsen9vprw95et60t2m",
  "description": "This is only a test...",
  "image": {
    "src": "https://assets.session.services/my-image.jpg",
    "alt": "My Image",
    "width": 1080,
    "height": 1080
  },
  "tracking": {
    "fbId": "485739562847563",
    "gaId": "G-PSW1MY7HB4",
    "tikTokId": "BQCKPH3RC77U8GPMLJ5G"
  },
  "locationId": "loc_01jqpjksnsen9vprw95et60t2m",
  "googlePlaceId": "ChIJN1t_tDeuEmsRUsoyG83frY4"
}

Response

OK

Example response

{
  "promoter": {
    "id": "pmt_01jqpjksnsen9vprw95et60t2m",
    "createdAt": "2026-10-17T08:46:46.696Z",
    "updatedAt": "2026-10-17T08:46:46.696Z",
    "name": "Session Services",
    "slug": "session-services",
    "teamId": "tem_01jqpjksnsen9vprw95et60t2m",
    "description": "This is only a test...",
    "approval": "APPROVED",
    "image": {
      "src": "https://assets.session.services/my-image.jpg",
      "alt": "My Image",
      "width": 1080,
      "height": 1080
    },
    "location": {
      "id": "loc_01hk153x00eh99pagyydz03sbz",
      "googlePlaceId": "ChIJP3Sa8ziYEmsRUKgyFmh9AQM",
      "createdAt": "2026-10-17T08:46:46.696Z",
      "updatedAt": "2026-10-17T08:46:46.696Z",
      "name": "Watson's EQ",
      "address": "The, Entertainment Quarter, 1 Bent St, Moore Park NSW 2021, Australia",
      "city": "Moore Park",
      "state": "New South Wales",
      "postcode": "2021",
      "country": "Australia",
      "latitude": -33.8944593,
      "longitude": 151.2252255,
      "timeZone": "Australia/Sydney",
      "types": [
        "establishment",
        "point_of_interest",
        "stadium"
      ],
      "description": "Historic outdoor amphitheater known for summer concerts",
      "image": {
        "src": "https://assets.session.services/my-image.jpg",
        "alt": "My Image",
        "width": 1080,
        "height": 1080
      },
      "venue": {
        "image": {
          "src": "https://assets.session.services/my-image.jpg",
          "alt": "My Image",
          "width": 1080,
          "height": 1080
        }
      }
    },
    "geohash": "r3gx1",
    "tracking": {
      "fbId": "485739562847563",
      "gaId": "G-PSW1MY7HB4",
      "tikTokId": "BQCKPH3RC77U8GPMLJ5G"
    }
  }
}

Changes

  • 84f157e4443aRevision changes
    • warning

      the request property's maxLength was set to 10000

    • info

      added the non-success response with the status