---
updatedAt: 2026-04-23T05:40:30.000Z
---

# Creates an event session

Creates an event session with the specified details. Session titles are capped at 65 characters by default; pass allow_long_title=true to raise the cap to 200 characters (useful when syncing events from external platforms with longer names).

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "API V1",
    "version": "v1"
  },
  "paths": {
    "/event_sessions": {
      "post": {
        "summary": "Creates an event session",
        "tags": [
          "Event Sessions"
        ],
        "description": "Creates an event session with the specified details. Session titles are capped at 65 characters by default; pass allow_long_title=true to raise the cap to 200 characters (useful when syncing events from external platforms with longer names).",
        "parameters": [],
        "responses": {
          "201": {
            "description": "event session created"
          },
          "422": {
            "description": "unprocessable entity"
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "event_id": {
                    "type": "integer",
                    "format": "int64",
                    "description": "Identifier for the Mobilize event",
                    "nullable": false
                  },
                  "start_time": {
                    "type": "integer",
                    "format": "int64",
                    "description": "UTC timestamp in seconds since the Unix epoch",
                    "nullable": true
                  },
                  "end_time": {
                    "type": "integer",
                    "format": "int64",
                    "description": "UTC timestamp in seconds since the Unix epoch",
                    "nullable": true
                  },
                  "event_type": {
                    "type": "string",
                    "description": "Type of session",
                    "nullable": true,
                    "enum": [
                      "virtual",
                      "in_person"
                    ]
                  },
                  "title": {
                    "type": "string",
                    "description": "Title of the event session. Maximum 65 characters, or 200 when allow_long_title is true.",
                    "nullable": false
                  },
                  "allow_long_title": {
                    "type": "boolean",
                    "description": "When true, raises the title cap from 65 to 200 characters (default: false)",
                    "nullable": true,
                    "default": false
                  },
                  "location_name": {
                    "type": "string",
                    "description": "Name of the location",
                    "nullable": true
                  },
                  "location_data": {
                    "type": "object",
                    "description": "Structured location details. `components` and `coordinates` may be sent either as native JSON (array/object) or as JSON-encoded strings; both are stored and returned as JSON strings. Neighborhood is the `components` entry whose `types` include \"neighborhood\"; NYC borough is the entry whose `types` include \"sublocality_level_1\".",
                    "properties": {
                      "components": {
                        "type": "string",
                        "description": "JSON-encoded array of Google-style address component objects ({ long_name, short_name, types: [] }). May also be sent as a native JSON array.",
                        "nullable": true
                      },
                      "coordinates": {
                        "type": "string",
                        "description": "JSON-encoded object of the form {\"lat\":<num>,\"lng\":<num>}. May also be sent as a native JSON object.",
                        "nullable": true
                      },
                      "address_city": {
                        "type": "string",
                        "nullable": true
                      },
                      "full_address": {
                        "type": "string",
                        "nullable": true
                      },
                      "address_state": {
                        "type": "string",
                        "nullable": true
                      },
                      "address_line_1": {
                        "type": "string",
                        "nullable": true
                      },
                      "address_country": {
                        "type": "string",
                        "nullable": true
                      },
                      "address_postal_code": {
                        "type": "string",
                        "nullable": true
                      }
                    }
                  },
                  "location_address": {
                    "type": "string",
                    "description": "Physical address of the event location",
                    "nullable": true
                  },
                  "show_rsvp_bar": {
                    "type": "boolean",
                    "description": "Flag to show RSVP buttons bar",
                    "nullable": true
                  },
                  "show_title_in_form": {
                    "type": "boolean",
                    "description": "Flag to show title in the form",
                    "nullable": true
                  },
                  "note": {
                    "type": "string",
                    "description": "Additional notes for the event session",
                    "nullable": true
                  },
                  "max_capacity": {
                    "type": "integer",
                    "description": "Maximum capacity for the event session",
                    "nullable": true
                  },
                  "tags": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Array of tags for the event session",
                    "nullable": true
                  }
                },
                "required": [
                  "event_id",
                  "start_time",
                  "end_time",
                  "title"
                ]
              }
            }
          },
          "required": true,
          "description": "Data containing event session information"
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.solidarity.tech/v1",
      "variables": {
        "defaultHost": {
          "default": "api.solidarity.tech/v1"
        }
      }
    }
  ],
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer"
      }
    }
  }
}
```