Create a sponsor

POST/v1/event/{eventId}/sponsors/create

US Region: https://public-api.sessionboard.com · EU Region: https://public-api-eu.sessionboard.com

Create a new sponsor in an event. Requires the write:sponsors scope. Subject to rate limiting (100 req/15min) and daily write quota (10,000/day per token).

Request example

curl --request POST \
  --url 'https://public-api.sessionboard.com/v1/event/{eventId}/sponsors/create' \
  --header 'x-access-token: <api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "custom_fields": {},
  "translated_fields": [
    {
      "parent_field_internal_name": "<string>",
      "translated_language": "<string>",
      "value": null
    }
  ]
}'

const response = await fetch('https://public-api.sessionboard.com/v1/event/{eventId}/sponsors/create', {
  method: 'POST',
  headers: {
    "x-access-token": "<api-token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "name": "<string>",
    "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "custom_fields": {},
    "translated_fields": [
      {
        "parent_field_internal_name": "<string>",
        "translated_language": "<string>",
        "value": null
      }
    ]
  }),
});

const data = await response.json();
console.log(data);

import requests

response = requests.request(
    "POST",
    "https://public-api.sessionboard.com/v1/event/{eventId}/sponsors/create",
    headers={
        "x-access-token": "<api-token>",
        "Content-Type": "application/json"
    },
    json={
        "name": "<string>",
        "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "custom_fields": {},
        "translated_fields": [
            {
                "parent_field_internal_name": "<string>",
                "translated_language": "<string>",
                "value": None
            }
        ]
    },
)

print(response.json())

<?php

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => "https://public-api.sessionboard.com/v1/event/{eventId}/sponsors/create",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => '{
  "name": "<string>",
  "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "custom_fields": {},
  "translated_fields": [
    {
      "parent_field_internal_name": "<string>",
      "translated_language": "<string>",
      "value": null
    }
  ]
}',
    CURLOPT_HTTPHEADER => [
        "x-access-token: <api-token>",
        "Content-Type: application/json",
    ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

package main

import (
  "fmt"
  "io"
  "net/http"
  "strings"
)

func main() {
  req, _ := http.NewRequest("POST", "https://public-api.sessionboard.com/v1/event/{eventId}/sponsors/create", strings.NewReader(`{
  "name": "<string>",
  "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "custom_fields": {},
  "translated_fields": [
    {
      "parent_field_internal_name": "<string>",
      "translated_language": "<string>",
      "value": null
    }
  ]
}`))
  req.Header.Add("x-access-token", "<api-token>")
  req.Header.Add("Content-Type", "application/json")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(string(body))
}

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://public-api.sessionboard.com/v1/event/{eventId}/sponsors/create"))
    .header("x-access-token", "<api-token>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\n  \"name\": \"<string>\",\n  \"account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"custom_fields\": {},\n  \"translated_fields\": [\n    {\n      \"parent_field_internal_name\": \"<string>\",\n      \"translated_language\": \"<string>\",\n      \"value\": null\n    }\n  ]\n}"))
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());

Try it

Response headers

Authorizations

x-access-tokenstringheader
Organization API token. Generate from Organization Settings → API Tokens.
AuthorizationBearer <token>headeror
OAuth 2.1 access token. Obtained via the OAuth PKCE flow at /oauth/token.

Send one of these. See Authentication.

Path parameters

eventIdintegerpathrequired
The event ID.

Request body

application/jsonrequired

namestring
Sponsor name. Required if account_id is not provided.
account_idstring<uuid>
Existing account ID to link, instead of creating a new account. Required if name is not provided. This is also how a group takes its second role: pass the account_id of a record that is already a sponsor or an exhibitor and it holds both roles on this event, under the same id. Repeating a link it already holds is a no-op.
custom_fieldsobject
Custom field values keyed by field internal name.

For number, currency, and percent fields, an empty string ("") clears the stored value — identical to sending null. 0 and "0" store an actual zero.

For checkbox fields, send boolean true or false. On read, a checked box serializes as the string "Yes", an explicitly unchecked one as "No", and a box that was never set as null.

Fields owned by an integration (for example swoogo_session_id, cvent_session_id, visit_session_id) are hydrated by the connector and reject writes with 400 FIELD_READ_ONLY, naming the field in details.field. Omit them from custom_fields.
translated_fieldsTranslatedFieldWrite[]
Language variants to write using the same shape returned on reads. Omit this key on update to leave existing translations unchanged.
Show child attributes
- parent_field_internal_namestringrequired
- translated_languagestringrequired
  Locale code for the language variant (for example fr or ar). Must be enabled on the event; otherwise the request fails with 400.
- valueany
  Value for that locale. Same type as the parent field.

Example

{
  "name": "<string>",
  "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "custom_fields": {},
  "translated_fields": [
    {
      "parent_field_internal_name": "<string>",
      "translated_language": "<string>",
      "value": null
    }
  ]
}

Responses

201`application/json`

Sponsor created

A sponsor associated with an event.

idstring
friendly_idstring
friendly_id_rawinteger
namestring
descriptionstring
logo_image_urlstring
banner_image_urlstring
phonestring
address_line_1string
address_line_2string
address_citystring
address_statestring
address_postal_codestring
address_coutnrystring
Country (note: field name contains a known typo preserved for backwards compatibility).
facebook_urlstring
instagram_urlstring
linkedin_urlstring
snapchat_usernamestring
tiktok_usernamestring
twitter_urlstring
website_urlstring
created_atstring
updated_atstring<date-time>
When the sponsor last changed, from any source, including Public API creates, updates and bulk writes. Send it back as updated_at on an update for optimistic concurrency; the write returns the new value.
custom_fieldsCustomFieldValue[]
Show child attributes
- idstring
- namestring
- valuestring | boolean | null
  The formatted field value, or null when the field is empty. Numeric field types (number, currency, percent, quantity, formula) serialize a stored zero as its formatted value (for example "0") — null means the field has no value, not that the value is zero.
  
  checkbox fields serialize as the strings "Yes" (checked) and "No" (explicitly unchecked); a checkbox that was never set is null. Writes take boolean true / false.
  
  datetime fields serialize as ISO 8601. On event custom fields (GET /v1/events?expand=custom_fields) the value is event-local time with the event's UTC offset (for example 2026-08-15T09:00:00-03:00), falling back to the raw UTC instant (2026-08-15T12:00:00.000Z) when the event has no valid timezone. On session, speaker, sponsor, and exhibitor custom fields the value is the raw UTC instant.
  
  date (date-only) fields serialize as M-DD-YYYY: month without a leading zero, day with one, four-digit year (for example 9-22-2026 for 22 September 2026, 3-04-2026 for 4 March 2026). This is not ISO 8601; parse it with that exact pattern.
- typestring
- internal_namestring
- created_atstring
translated_fieldsTranslatedField[]
Show child attributes
- idstring
- namestring
- typestring
- parent_field_idstring
- parent_field_sourcestring
- parent_field_namestring
- parent_field_internal_namestring
- translated_languagestring
- valuestring
contactsAccountContact[]
Show child attributes
- idstring
- friendly_idstring
- friendly_id_rawinteger
- full_namestring
- first_namestring
- last_namestring
- emailstring
- photo_urlstring
  URL of the contact's headshot. Images larger than 2 MB are delivered resized from this URL, scaled to fit within 2400 x 2400 pixels (a PNG may arrive as WebP for clients that accept it). The uploaded file is stored unchanged; for full-resolution originals use the bulk download tools in Sessionboard, such as Download Headshots (Contacts, More menu).
- company_namestring
- titlestring
- aboutstring
- is_primaryboolean
- contact_created_atstring
- contact_updated_atstring
- relationship_created_atstring
- relationship_updated_atstring
admin_urlstring<uri> | null
Deep link to this entity in the Sessionboard admin UI.

400

Validation error

401

Unauthorized

403

Insufficient scope or feature not enabled

429

Rate limit or daily quota exceeded

Response examples

{
  "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "friendly_id": "SPON-3",
  "friendly_id_raw": 3,
  "name": "TechCorp Global",
  "description": "Platinum sponsor and technology partner.",
  "logo_image_url": "https://cdn.sessionboard.com/logos/techcorp.png",
  "phone": "+1-555-0100",
  "address_city": "San Francisco",
  "address_state": "CA",
  "address_coutnry": "US",
  "website_url": "https://www.techcorp.example.com",
  "linkedin_url": "https://www.linkedin.com/company/techcorp",
  "created_at": "2024-01-05T08:00:00Z",
  "updated_at": "2024-02-20T12:00:00Z",
  "custom_fields": [],
  "translated_fields": [],
  "contacts": []
}