> ## Documentation Index > Fetch the complete documentation index at: https://loops.so/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create a campaign > Create a draft marketing campaign and its associated email message. This endpoint creates a draft campaign and an empty email message in one step. Use the returned `emailMessageId` with [Update an email message](/docs/api-reference/update-email-message) to set subject, sender, preview text, and LMX content. The audience (mailing list, segment, or filter), group, and scheduling can be set on create or later via [Update a campaign](/docs/api-reference/update-campaign). To send a test preview of a campaign, use the [Preview email message](/docs/api-reference/preview-email-message) endpoint. ## OpenAPI ````yaml /openapi.json post /v1/campaigns openapi: 3.1.0 info: title: Loops OpenAPI Spec description: This is the OpenAPI Spec for the [Loops API](https://loops.so/docs/api). version: 1.20.0 servers: - url: https://app.loops.so/api security: [] tags: - name: API key - name: Audience segments description: View audience segments - name: Campaigns description: Create and manage email campaigns - name: Campaign groups description: Organize campaigns into groups - name: Components description: View email components - name: Configuration description: View configuration settings - name: Contacts description: Manage contacts in your audience - name: Contact properties description: Manage contact properties - name: Email messages description: Manage email message content for campaigns - name: Events description: Trigger workflows with events - name: Event patterns description: View workflow event patterns - name: Mailing lists description: View mailing lists - name: Themes description: View email themes - name: Transactional emails description: Create, manage, and send transactional emails - name: Transactional groups description: Organize transactional emails into groups - name: Uploads description: Upload image assets - name: Workflows description: View and mutate workflow graphs - name: Workflow nodes description: View and mutate workflow nodes paths: /v1/campaigns: post: tags: - Campaigns summary: Create a campaign description: >- Create a new draft campaign. An empty email message is created automatically and its `emailMessageId` is returned. Use the `/email-messages/{emailMessageId}` endpoint to set subject, sender, preview text, and LMX content. The audience (mailing list, segment, or filter), group, and scheduling can be set on create or later via update. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateCampaignRequest' responses: '201': description: Campaign created. content: application/json: schema: $ref: '#/components/schemas/CreateCampaignResponse' '400': description: >- Invalid request body, campaign group not found, or no sending domain configured. content: application/json: schema: $ref: '#/components/schemas/CampaignFailureResponse' '401': description: Invalid API key or content API not enabled for this team. '404': description: Referenced mailing list or audience segment not found. content: application/json: schema: $ref: '#/components/schemas/CampaignFailureResponse' '405': description: Wrong HTTP request method. security: - apiKey: [] components: schemas: CreateCampaignRequest: type: object properties: name: type: string description: The campaign name. examples: - Spring announcement campaignGroupId: type: string description: >- The ID of the group to add this campaign to. Defaults to the team's default group when omitted. mailingListId: type: - string - 'null' description: The ID of the mailing list to send to. audienceSegmentId: type: - string - 'null' description: >- The ID of an audience segment. Setting this clears any `audienceFilter`. audienceFilter: $ref: '#/components/schemas/AudienceFilter' scheduling: $ref: '#/components/schemas/CampaignSchedulingRequest' required: - name additionalProperties: false CreateCampaignResponse: type: object properties: id: type: string description: The ID of the campaign. name: type: string description: The name of the campaign. status: type: string examples: - Draft description: The status of the campaign. createdAt: type: string format: date-time description: ISO 8601 timestamp for when the campaign was created. updatedAt: type: string format: date-time description: ISO 8601 timestamp for when the campaign was last updated. emailMessageId: type: - string - 'null' description: >- The ID of the empty email message created for this campaign. Use `POST /v1/email-messages/{emailMessageId}` to set its fields and LMX content. emailMessageContentRevisionId: type: - string - 'null' description: >- The `contentRevisionId` of the newly created email message. Pass this as `expectedRevisionId` on your first update. campaignGroupId: type: - string - 'null' description: The ID of the campaign group this campaign belongs to, if set. mailingListId: type: - string - 'null' description: The ID of the mailing list this campaign sends to, if set. audienceSegmentId: type: - string - 'null' description: The ID of the audience segment this campaign targets, if set. audienceFilter: $ref: '#/components/schemas/AudienceFilter' description: The filter rules that define the audience for this campaign, if set. scheduling: $ref: '#/components/schemas/CampaignScheduling' description: When the campaign is scheduled to send. required: - id - name - status - createdAt - updatedAt - emailMessageId - emailMessageContentRevisionId - campaignGroupId - mailingListId - audienceSegmentId - audienceFilter - scheduling CampaignFailureResponse: type: object properties: message: type: string required: - message AudienceFilter: type: - object - 'null' description: >- A tree of audience conditions combined with `match`. Null when the campaign targets a mailing list or segment without an explicit filter. properties: match: type: string enum: - all - any conditions: type: array minItems: 1 items: $ref: '#/components/schemas/AudienceFilterCondition' required: - match - conditions additionalProperties: false CampaignSchedulingRequest: type: object description: >- When the campaign should send. `timestamp` is required and must be in the future when `method` is `schedule`, and must be omitted when `method` is `now`. properties: method: type: string enum: - now - schedule timestamp: type: string format: date-time required: - method additionalProperties: false CampaignScheduling: type: object description: When the campaign is scheduled to send. properties: method: type: string enum: - now - schedule timestamp: type: - string - 'null' format: date-time description: ISO 8601 send time. Null when the method is `now`. required: - method - timestamp AudienceFilterCondition: oneOf: - $ref: '#/components/schemas/PropertyCondition' - $ref: '#/components/schemas/OptInCondition' - $ref: '#/components/schemas/ActivityCondition' discriminator: propertyName: type PropertyCondition: type: object description: Matches contacts by a property value. properties: type: type: string enum: - property key: type: string description: The contact property name. operator: type: string enum: - any - contains - notContains - equals - notEquals - greaterThan - lessThan - isTrue - isFalse - empty - notEmpty - dateEmpty - dateNotEmpty - after - before - between value: description: >- The comparison value. Omitted for value-less operators (e.g. `isTrue`, `empty`). A `{ from, to }` object for `between`. oneOf: - type: string - type: number - type: object properties: from: type: string format: date-time to: type: string format: date-time required: - from - to required: - type - key - operator OptInCondition: type: object description: Matches contacts by mailing-list opt-in status. properties: type: type: string enum: - optIn status: type: - string - 'null' enum: - accepted - pending - rejected - null required: - type - status ActivityCondition: type: object description: Matches contacts by their activity on a campaign or workflow. properties: type: type: string enum: - activity action: type: string enum: - sent - opened - clicked negate: type: boolean target: type: string enum: - campaign - workflow - workflowEmail id: type: string description: The ID of the campaign, workflow, or workflow email. required: - type - action - negate - target - id securitySchemes: apiKey: type: http scheme: bearer ````