---
title: "POST /4.0/diagram-automation/partner/event-diagrams"
method: POST
path: "/4.0/diagram-automation/partner/event-diagrams"
tags: ["Diagram Automation"]
---

# POST /4.0/diagram-automation/partner/event-diagrams

`POST /4.0/diagram-automation/partner/event-diagrams`

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

## Request body

- EventDiagramsPartnerIntegrationPostBodyLayoutAutomationService
  - `eventName` string, required
  - `startTime` string, 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`.
  - `endTime` string, 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`.
  - `public` boolean — Whether the event is publicly accessible.
  - `category` string
  - `usesMetric` boolean — Whether the event's diagram uses metric units.
  - `externalEventId` string, 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.
  - `diagrams` EventDiagramsPartnerIntegrationPostBodyDiagramLayoutAutomationService[], required
    - `diagramName` string, required
    - `roomId` string, required — The Cvent room identifier for the room in which the event is to occur.
    - `propertyId` string, required — The Cvent property identifier for the property at which the event is to occur.
    - `externalDiagramId` string, required — An external identifier for the diagram, which can be used to associate it with a booking in an external system. An error will occur if this value is already in use by another diagram.
    - `customSetup` string — The name of a custom setup to apply to the diagram. Requires `attendees`. Mutually exclusive with `layoutSpec`.
    - `attendees` integer — The number of attendees to seat. Required when `customSetup` is provided.
    - `layoutSpec` object — A layout specification describing the desired seating arrangement. Mutually exclusive with `customSetup`.

## Response `200`

Summary information of the newly created event and diagrams

- EventDiagramsPostResponseBodyLayoutAutomationService
  - `event` EventDiagramsPostResponseBodyEventLayoutAutomationService, required
    - `eventId` string, required
    - `eventUrl` string, uri, required — A URL that can be used to view the event in the web application.
    - `eventName` string, required
    - `externalEventId` string
    - `public` boolean, required — Whether the event is publicly accessible.
    - `category` string, required
    - `usesMetric` boolean, required — Whether the event's diagram uses metric units.
    - `diagrams` EventDiagramsPostResponseBodyDiagramLayoutAutomationService[], required
      - `diagramId` string, required
      - `diagramName` string, required
      - `diagramUrl` string, uri, required — A URL that can be used to view the diagram in the web application.
      - `pdfUrl` string, uri, required — A URL that can be used to view/download the diagram as a PDF document.
      - `externalDiagramId` string
    - `createdAt` string, date-time, required — The date/time at which the event was created.
    - `updatedAt` string, date-time, required — The date/time at which the event was last updated.

## Other responses

- `400` — Invalid/malformed request
- `401` — Unauthorized
- `403` — Access Denied
- `409` — Conflict -- External ID already in use
- `422` — Invalid Request -- contains one or more invalid fields
- `500` — Unexpected Server Error

---

[API](https://skmtc.net/socialtables/apis/social-tables-api-gateway.md) · [All operations](https://skmtc.net/socialtables/apis/social-tables-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/socialtables/social-tables-api-gateway/revisions/b8bbb74a1212/schema)