Sign in
Diagram Automation

Creates an event and one or more diagrams for partners with Cvent room and property IDs. No external ID mapping is performed.

post/4.0/diagram-automation/partner/event-diagrams

Request body

eventNamestring required
startTimestring date-time required

The date/time (UTC) at which the event begins. Must be in ISO 8601 format. Value must not be later than endTime.

endTimestring date-time required

The date/time (UTC) at which the event ends. Must be in ISO 8601 format. Value must not be earlier than startTime.

publicboolean

Whether the event is publicly accessible.

categorystring
usesMetricboolean

Whether the event's diagram uses metric units.

externalEventIdstring required

An external identifier for the event used to idempotently resolve existing events. If this value matches an existing event's external ID, diagrams are created on that event rather than creating a new one.

Example request

{
  "eventName": "Event Diagramming Conference",
  "startTime": "2025-04-01T00:00:00Z",
  "endTime": "2025-04-04T23:59:59Z",
  "public": true,
  "category": "Conference",
  "usesMetric": false,
  "externalEventId": "external-event-123",
  "diagrams": [
    {
      "diagramName": "Keynote Speech -- Main Ballroom",
      "roomId": "cm47keakr1yddwenp3il4fn4y",
      "propertyId": "ckvg9e4t8001e0kyx7pux5h0o",
      "externalDiagramId": "external-diagram-123"
    }
  ]
}

Response

Summary information of the newly created event and diagrams

Example response

{
  "event": {
    "eventId": "1fde7979-c808-4524-9a58-7d96a0123456",
    "eventUrl": "https://home.socialtables.com/events/1fde7979-c808-4524-9a58-7d96a0123456",
    "externalEventId": "external-event-123",
    "eventName": "Event Diagramming Conference",
    "startTime": "2025-04-01T00:00:00Z",
    "endTime": "2025-04-04T23:59:59Z",
    "public": true,
    "category": "Conference",
    "usesMetric": false,
    "diagrams": [
      {
        "diagramId": "c9069ae3-0741-4c88-a3f7-89f0f40a1234",
        "diagramName": "Keynote Speech -- Main Ballroom",
        "roomId": "c1234abcd90123456abcd123",
        "externalDiagramId": "external-diagram-123",
        "pdfUrl": "https://diagram.socialtables.com/diagram/c9069ae3-0741-4c88-a3f7-89f0f40a1234/pdf",
        "diagramUrl": "https://diagram.socialtables.com/diagram/c9069ae3-0741-4c88-a3f7-89f0f40a1234"
      },
      {
        "diagramId": "c6045f60-7053-418f-9ab7-7bfa95a0432b",
        "diagramName": "Breakout Session -- Room 101",
        "roomId": "c1234abcd90123456xyz56789",
        "externalDiagramId": "external-diagram-101",
        "pdfUrl": "https://diagram.socialtables.com/diagram/c6045f60-7053-418f-9ab7-7bfa95a0432b/pdf",
        "diagramUrl": "https://diagram.socialtables.com/diagram/c6045f60-7053-418f-9ab7-7bfa95a0432b"
      }
    ],
    "createdAt": "2025-03-25T18:42:35.000Z",
    "updatedAt": "2025-03-25T18:42:35.000Z"
  }
}