# Campaigns

Campaigns resources of the Mailjet Email API.

## Campaign Draft List

 - [GET /v3/REST/campaigndraft](https://dev.mailjet.com/openapi/openapi-mailjet/campaigns/get_v3_campaigndraft.md): Retrieve details on the configuration of all campaign drafts. Newsletter and CampaignDraft objects are differentiated by the EditMode values. We recommend using CampaignDraft, as Newsletter objects are ones created using the legacy Mailjet template builder.

## Create Campaign Draft

 - [POST /v3/REST/campaigndraft](https://dev.mailjet.com/openapi/openapi-mailjet/campaigns/post_v3_campaigndraft.md): Create a new campaign draft. Newsletter and CampaignDraft objects are differentiated by the EditMode values - we recommend using CampaignDraft, as Newsletter objects are ones created using the legacy Mailjet template builder.

## Campaign Draft by ID

 - [GET /v3/REST/campaigndraft/{draft_ID}](https://dev.mailjet.com/openapi/openapi-mailjet/campaigns/get_v3_campaigndraft_id.md): Retrieve details on the configuration of a specific campaign draft. Newsletter and CampaignDraft objects are differentiated by the EditMode values - we recommend using CampaignDraft, as Newsletter objects are ones created using the legacy Mailjet template builder. To obtain a valid draft_ID, first call GET /v3/REST/campaigndraft to list your campaign drafts.

## Update Campaign Draft

 - [PUT /v3/REST/campaigndraft/{draft_ID}](https://dev.mailjet.com/openapi/openapi-mailjet/campaigns/put_v3_campaigndraft_id.md): Update the configuration settings of a specific campaign draft. Newsletter and CampaignDraft objects are differentiated by the EditMode values - we recommend using CampaignDraft, as Newsletter objects are ones created using the legacy Mailjet template builder. To obtain a valid draft_ID, first call GET /v3/REST/campaigndraft to list your campaign drafts.

## Get Campaign Draft: Detail Content

 - [GET /v3/REST/campaigndraft/{draft_ID}/detailcontent](https://dev.mailjet.com/openapi/openapi-mailjet/campaigns/get_v3_campaigndraft_id_detailcontent.md): Retrieve the content of your campaign draft email. It will be split between a Text part, HTML part, MJML content and/or additional headers. To obtain a valid draft_ID, first call GET /v3/REST/campaigndraft to list your campaign drafts.

## Campaign Draft: Detail Content

 - [POST /v3/REST/campaigndraft/{draft_ID}/detailcontent](https://dev.mailjet.com/openapi/openapi-mailjet/campaigns/post_v3_campaigndraft_id_detailcontent.md): Create, update or delete the content of your campaign draft email. You can select a Text part, HTML part, MJML content, as well as additional headers.

Each POST request overwrites any content previously added - e.g. if you have submitted HTML content on the initial POST, and on the next you only submit Text content, the previously saved value of Html-part will be deleted.
 To obtain a valid draft_ID, first call GET /v3/REST/campaigndraft to list your campaign drafts.

## Campaign Draft: Test

 - [POST /v3/REST/campaigndraft/{draft_ID}/test](https://dev.mailjet.com/openapi/openapi-mailjet/campaigns/post_v3_campaigndraft_id_test.md): Test a created campaign draft by sending it to a selection of recipients. The status of the campaign draft will not be affected by the test. To obtain a valid draft_ID, first call GET /v3/REST/campaigndraft to list your campaign drafts.

## Get Campaign Draft: Schedule

 - [GET /v3/REST/campaigndraft/{draft_ID}/schedule](https://dev.mailjet.com/openapi/openapi-mailjet/campaigns/get_v3_campaigndraft_id_schedule.md): Retrieve the sending schedule of a campaign draft. To obtain a valid draft_ID, first call GET /v3/REST/campaigndraft to list your campaign drafts.

## Campaign Draft: Schedule

 - [POST /v3/REST/campaigndraft/{draft_ID}/schedule](https://dev.mailjet.com/openapi/openapi-mailjet/campaigns/post_v3_campaigndraft_id_schedule.md): Schedule the sending of a campaign draft.

## Update Campaign Draft: Schedule

 - [PUT /v3/REST/campaigndraft/{draft_ID}/schedule](https://dev.mailjet.com/openapi/openapi-mailjet/campaigns/put_v3_campaigndraft_id_schedule.md): Update the sending schedule of a campaign draft.

## Delete Campaign Draft: Schedule

 - [DELETE /v3/REST/campaigndraft/{draft_ID}/schedule](https://dev.mailjet.com/openapi/openapi-mailjet/campaigns/delete_v3_campaigndraft_id_schedule.md): Cancel the scheduled sending of a campaign draft.

## Campaign Draft: Send

 - [POST /v3/REST/campaigndraft/{draft_ID}/send](https://dev.mailjet.com/openapi/openapi-mailjet/campaigns/post_v3_campaigndraft_id_send.md): Send a campaign draft immediately.

## Get Campaign Draft: Status

 - [GET /v3/REST/campaigndraft/{draft_ID}/status](https://dev.mailjet.com/openapi/openapi-mailjet/campaigns/get_v3_campaigndraft_id_status.md): View the sending status of a campaign draft. To obtain a valid draft_ID, first call GET /v3/REST/campaigndraft to list your campaign drafts.

## Campaign List

 - [GET /v3/REST/campaign](https://dev.mailjet.com/openapi/openapi-mailjet/campaigns/get_v3_campaign.md): Retrieve details about a list of sent campaigns - creation and sending time, sender, subject, tracking options enabled etc. Each e-mail going through Mailjet is attached to a Campaign. This object is automatically generated by Mailjet.

> Note: If no query parameters are used, only campaigns sent since 00:00 UTC on the current day will be returned.

## Campaign by ID

 - [GET /v3/REST/campaign/{campaign_ID}](https://dev.mailjet.com/openapi/openapi-mailjet/campaigns/get_v3_campaign_id.md): Retrieve details about a specific campaign - creation and sending time, sender, subject, tracking options enabled etc. Each e-mail going through Mailjet is attached to a Campaign. This object is automatically generated by Mailjet. To obtain a valid campaign_ID, first call GET /v3/REST/campaign to list your campaigns.

## Update Campaign

 - [PUT /v3/REST/campaign/{campaign_ID}](https://dev.mailjet.com/openapi/openapi-mailjet/campaigns/put_v3_campaign_id.md): Manage the deletion and "starred" status of a campaign. Each e-mail going through Mailjet is attached to a Campaign. This object is automatically generated by Mailjet. To obtain a valid campaign_ID, first call GET /v3/REST/campaign to list your campaigns.

