POST api/Campaigns

Creates a campaign.

Request Information

URI Parameters

None.

Body Parameters

The campaign model to create with.

Name	Type	Additional information
Name	string	None.
PublicId	string	None.
ModifiedDateUtc	date	None.
UserJourney	string	None.
ServiceType	ServiceTypeDto	None.
Quantity	integer	None.
ApprovalResponses	Collection of ApprovalResponseDto	None.
SupplierId	globally unique identifier	None.
OrderId	globally unique identifier	None.
CampaignProperties	Collection of PayCampaignPropertyDto	None.
Voucher	VoucherDto	None.
OrderStatusChanges	Collection of StatusChangeDto	None.
OrderStatus	string	None.
IsTemporary	boolean	None.
RB_ArtWorkToken	string	None.
PR_Key	string	None.
PR_UDPRN	string	None.
Ext_TemplateId	integer	None.
Ext_ArtworkId	integer	None.
Ext_ResourceId	integer	None.
FileLocation	string	None.
OrganisationId	globally unique identifier	None.
OrganisationName	string	None.
TemplateName	string	None.
UserName	string	None.
Ext_MailerType	string	None.
Envelope	string	None.
Variant	string	None.
ApprovalGroupId	globally unique identifier	None.
DeliveryDate	date	None.
PaperSize	string	None.
CentralMailerCampaignId	globally unique identifier	None.
OrderProductionCompletedDate	date	None.
Id	globally unique identifier	None.
CreationDateUtc	date	None.
UserId	globally unique identifier	None.
TenantId	globally unique identifier	None.
SubtotalExVat	decimal number	None.
SubtotalIncVat	decimal number	None.
DiscountedTotalExVat	decimal number	None.
DiscountedTotalIncVat	decimal number	None.
VatRateApplied	decimal number	None.

Request Formats

application/json, text/json

Sample:

{
  "Name": "sample string 1",
  "PublicId": "sample string 2",
  "ModifiedDateUtc": "2026-10-23T13:15:41.0476041+00:00",
  "UserJourney": "sample string 3",
  "ServiceType": 0,
  "Quantity": 4,
  "ApprovalResponses": [
    {
      "Id": "bca59fdc-a387-4e1a-8aad-ca7c23364348",
      "CreationDate": "2026-10-23T13:15:41.0476041+00:00",
      "ApproverUserId": "bf29563d-11c8-4c56-82e3-9ecb2a225be7",
      "Note": "sample string 4",
      "Status": 0,
      "CampaignId": "29c2938e-7ad8-4030-a0e3-a393497eb337"
    },
    {
      "Id": "bca59fdc-a387-4e1a-8aad-ca7c23364348",
      "CreationDate": "2026-10-23T13:15:41.0476041+00:00",
      "ApproverUserId": "bf29563d-11c8-4c56-82e3-9ecb2a225be7",
      "Note": "sample string 4",
      "Status": 0,
      "CampaignId": "29c2938e-7ad8-4030-a0e3-a393497eb337"
    }
  ],
  "SupplierId": "713f716d-ad7d-4235-a26c-ae4045124b0c",
  "OrderId": "54f689cd-be5e-48cb-9afa-566509f6fa2c",
  "CampaignProperties": [
    {
      "Id": "ec25fff4-aa6b-4e26-b727-bdb250f7cc78",
      "CampaignId": "c9b0fff4-774a-495d-ad0b-28f875ca0886",
      "Name": "sample string 3",
      "Value": "sample string 4"
    },
    {
      "Id": "ec25fff4-aa6b-4e26-b727-bdb250f7cc78",
      "CampaignId": "c9b0fff4-774a-495d-ad0b-28f875ca0886",
      "Name": "sample string 3",
      "Value": "sample string 4"
    }
  ],
  "Voucher": {
    "Id": 1,
    "Description": "sample string 2",
    "VoucherCode": "sample string 3",
    "TenantId": "sample string 4",
    "StartDate": "2026-10-23T13:15:41.0476041+00:00",
    "ExpiryDate": "2026-10-23T13:15:41.0476041+00:00",
    "Cancelled": true,
    "IsPercentageDiscount": true,
    "Entitlement": 7.0,
    "MinSpend": 1.0,
    "MaxSpend": 1.0,
    "MaxDiscount": 1.0,
    "ForAllUsers": true,
    "Deleted": true,
    "VoucherUsers": [
      {
        "UserId": "276952e5-0082-4878-9f9a-25abf3e8be4a",
        "SingleUse": true,
        "ApplyAutomatically": true
      },
      {
        "UserId": "276952e5-0082-4878-9f9a-25abf3e8be4a",
        "SingleUse": true,
        "ApplyAutomatically": true
      }
    ],
    "MinimumQuantity": 1,
    "VoucherProductType": "sample string 10",
    "NewCustomerOnly": true,
    "VoucherProperties": [
      {
        "Id": "171589d5-94fd-467e-a62f-9abababbf562",
        "CreationDateUtc": "2026-10-23T13:15:41.0476041+00:00",
        "VoucherId": 3,
        "Name": "sample string 4",
        "Value": "sample string 5",
        "Type": 0
      },
      {
        "Id": "171589d5-94fd-467e-a62f-9abababbf562",
        "CreationDateUtc": "2026-10-23T13:15:41.0476041+00:00",
        "VoucherId": 3,
        "Name": "sample string 4",
        "Value": "sample string 5",
        "Type": 0
      }
    ]
  },
  "OrderStatusChanges": [
    {
      "Id": 1,
      "Status": "sample string 2",
      "ChangeDateUtc": "2026-10-23T13:15:41.0476041+00:00",
      "Description": "sample string 4",
      "UserId": "e1dd7eb5-549c-4738-b30b-174533ef51c6"
    },
    {
      "Id": 1,
      "Status": "sample string 2",
      "ChangeDateUtc": "2026-10-23T13:15:41.0476041+00:00",
      "Description": "sample string 4",
      "UserId": "e1dd7eb5-549c-4738-b30b-174533ef51c6"
    }
  ],
  "OrderStatus": "sample string 2",
  "IsTemporary": true,
  "RB_ArtWorkToken": "sample string 7",
  "PR_Key": "sample string 8",
  "PR_UDPRN": "sample string 9",
  "Ext_TemplateId": 1,
  "Ext_ArtworkId": 1,
  "Ext_ResourceId": 1,
  "FileLocation": "sample string 10",
  "OrganisationId": "5d8f99a4-0d33-43bd-ab16-f1af1d10fe17",
  "OrganisationName": "sample string 11",
  "TemplateName": "sample string 12",
  "UserName": "sample string 13",
  "Ext_MailerType": "sample string 14",
  "Envelope": "sample string 15",
  "Variant": "sample string 16",
  "ApprovalGroupId": "0f2b31a8-cb2c-41eb-9b3d-398a4ffe5cd7",
  "DeliveryDate": "2026-10-23T13:15:41.0476041+00:00",
  "PaperSize": "sample string 17",
  "CentralMailerCampaignId": "bc9e335d-076c-441e-bbba-f8f7e28f7685",
  "OrderProductionCompletedDate": null,
  "Id": "06df8466-8a61-4a1d-ac2b-fc1f0eb82312",
  "CreationDateUtc": "2026-10-23T13:15:41.0476041+00:00",
  "UserId": "87f81818-118d-4954-95ad-5b75262c64f1",
  "TenantId": "81415d4b-baa4-4570-ada4-f805299f3173",
  "SubtotalExVat": 22.0,
  "SubtotalIncVat": 23.0,
  "DiscountedTotalExVat": 24.0,
  "DiscountedTotalIncVat": 25.0,
  "VatRateApplied": 26.0
}

application/xml, text/xml

Sample:

<PayCampaignDto xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Aardvark.Pay.Models">
  <CreationDateUtc xmlns="http://schemas.datacontract.org/2004/07/Aardvark.Library.ServiceModels.DataTransferObjects">2026-10-23T13:15:41.0476041+00:00</CreationDateUtc>
  <DiscountedTotalExVat xmlns="http://schemas.datacontract.org/2004/07/Aardvark.Library.ServiceModels.DataTransferObjects">24</DiscountedTotalExVat>
  <DiscountedTotalIncVat xmlns="http://schemas.datacontract.org/2004/07/Aardvark.Library.ServiceModels.DataTransferObjects">25</DiscountedTotalIncVat>
  <Id xmlns="http://schemas.datacontract.org/2004/07/Aardvark.Library.ServiceModels.DataTransferObjects">06df8466-8a61-4a1d-ac2b-fc1f0eb82312</Id>
  <SubtotalExVat xmlns="http://schemas.datacontract.org/2004/07/Aardvark.Library.ServiceModels.DataTransferObjects">22</SubtotalExVat>
  <SubtotalIncVat xmlns="http://schemas.datacontract.org/2004/07/Aardvark.Library.ServiceModels.DataTransferObjects">23</SubtotalIncVat>
  <TenantId xmlns="http://schemas.datacontract.org/2004/07/Aardvark.Library.ServiceModels.DataTransferObjects">81415d4b-baa4-4570-ada4-f805299f3173</TenantId>
  <UserId xmlns="http://schemas.datacontract.org/2004/07/Aardvark.Library.ServiceModels.DataTransferObjects">87f81818-118d-4954-95ad-5b75262c64f1</UserId>
  <VatRateApplied xmlns="http://schemas.datacontract.org/2004/07/Aardvark.Library.ServiceModels.DataTransferObjects">26</VatRateApplied>
  <ApprovalGroupId>0f2b31a8-cb2c-41eb-9b3d-398a4ffe5cd7</ApprovalGroupId>
  <ApprovalResponses>
    <ApprovalResponseDto>
      <ApproverUserId>bf29563d-11c8-4c56-82e3-9ecb2a225be7</ApproverUserId>
      <CampaignId>29c2938e-7ad8-4030-a0e3-a393497eb337</CampaignId>
      <CreationDate>2026-10-23T13:15:41.0476041+00:00</CreationDate>
      <Id>bca59fdc-a387-4e1a-8aad-ca7c23364348</Id>
      <Note>sample string 4</Note>
      <Status>Approved</Status>
    </ApprovalResponseDto>
    <ApprovalResponseDto>
      <ApproverUserId>bf29563d-11c8-4c56-82e3-9ecb2a225be7</ApproverUserId>
      <CampaignId>29c2938e-7ad8-4030-a0e3-a393497eb337</CampaignId>
      <CreationDate>2026-10-23T13:15:41.0476041+00:00</CreationDate>
      <Id>bca59fdc-a387-4e1a-8aad-ca7c23364348</Id>
      <Note>sample string 4</Note>
      <Status>Approved</Status>
    </ApprovalResponseDto>
  </ApprovalResponses>
  <CampaignProperties>
    <PayCampaignPropertyDto>
      <CampaignId>c9b0fff4-774a-495d-ad0b-28f875ca0886</CampaignId>
      <Id>ec25fff4-aa6b-4e26-b727-bdb250f7cc78</Id>
      <Name>sample string 3</Name>
      <Value>sample string 4</Value>
    </PayCampaignPropertyDto>
    <PayCampaignPropertyDto>
      <CampaignId>c9b0fff4-774a-495d-ad0b-28f875ca0886</CampaignId>
      <Id>ec25fff4-aa6b-4e26-b727-bdb250f7cc78</Id>
      <Name>sample string 3</Name>
      <Value>sample string 4</Value>
    </PayCampaignPropertyDto>
  </CampaignProperties>
  <CentralMailerCampaignId>bc9e335d-076c-441e-bbba-f8f7e28f7685</CentralMailerCampaignId>
  <DeliveryDate>2026-10-23T13:15:41.0476041+00:00</DeliveryDate>
  <Envelope>sample string 15</Envelope>
  <Ext_ArtworkId>1</Ext_ArtworkId>
  <Ext_MailerType>sample string 14</Ext_MailerType>
  <Ext_ResourceId>1</Ext_ResourceId>
  <Ext_TemplateId>1</Ext_TemplateId>
  <FileLocation>sample string 10</FileLocation>
  <IsTemporary>true</IsTemporary>
  <ModifiedDateUtc>2026-10-23T13:15:41.0476041+00:00</ModifiedDateUtc>
  <Name>sample string 1</Name>
  <OrderId>54f689cd-be5e-48cb-9afa-566509f6fa2c</OrderId>
  <OrderStatusChanges>
    <StatusChangeDto>
      <ChangeDateUtc>2026-10-23T13:15:41.0476041+00:00</ChangeDateUtc>
      <Description>sample string 4</Description>
      <Id>1</Id>
      <Status>sample string 2</Status>
      <UserId>e1dd7eb5-549c-4738-b30b-174533ef51c6</UserId>
    </StatusChangeDto>
    <StatusChangeDto>
      <ChangeDateUtc>2026-10-23T13:15:41.0476041+00:00</ChangeDateUtc>
      <Description>sample string 4</Description>
      <Id>1</Id>
      <Status>sample string 2</Status>
      <UserId>e1dd7eb5-549c-4738-b30b-174533ef51c6</UserId>
    </StatusChangeDto>
  </OrderStatusChanges>
  <OrganisationId>5d8f99a4-0d33-43bd-ab16-f1af1d10fe17</OrganisationId>
  <OrganisationName>sample string 11</OrganisationName>
  <PR_Key>sample string 8</PR_Key>
  <PR_UDPRN>sample string 9</PR_UDPRN>
  <PaperSize>sample string 17</PaperSize>
  <PublicId>sample string 2</PublicId>
  <Quantity>4</Quantity>
  <RB_ArtWorkToken>sample string 7</RB_ArtWorkToken>
  <ServiceType>DesignPrintAndDistribution</ServiceType>
  <SupplierId>713f716d-ad7d-4235-a26c-ae4045124b0c</SupplierId>
  <TemplateName>sample string 12</TemplateName>
  <UserJourney>sample string 3</UserJourney>
  <UserName>sample string 13</UserName>
  <Variant>sample string 16</Variant>
  <Voucher>
    <Cancelled>true</Cancelled>
    <Deleted>true</Deleted>
    <Description>sample string 2</Description>
    <Entitlement>7</Entitlement>
    <ExpiryDate>2026-10-23T13:15:41.0476041+00:00</ExpiryDate>
    <ForAllUsers>true</ForAllUsers>
    <Id>1</Id>
    <IsPercentageDiscount>true</IsPercentageDiscount>
    <MaxDiscount>1</MaxDiscount>
    <MaxSpend>1</MaxSpend>
    <MinSpend>1</MinSpend>
    <MinimumQuantity>1</MinimumQuantity>
    <NewCustomerOnly>true</NewCustomerOnly>
    <StartDate>2026-10-23T13:15:41.0476041+00:00</StartDate>
    <TenantId>sample string 4</TenantId>
    <VoucherCode>sample string 3</VoucherCode>
    <VoucherProductType>sample string 10</VoucherProductType>
    <VoucherProperties>
      <VoucherPropertyDto>
        <CreationDateUtc>2026-10-23T13:15:41.0476041+00:00</CreationDateUtc>
        <Id>171589d5-94fd-467e-a62f-9abababbf562</Id>
        <Name>sample string 4</Name>
        <Type>PrintingOptions</Type>
        <Value>sample string 5</Value>
        <VoucherId>3</VoucherId>
      </VoucherPropertyDto>
      <VoucherPropertyDto>
        <CreationDateUtc>2026-10-23T13:15:41.0476041+00:00</CreationDateUtc>
        <Id>171589d5-94fd-467e-a62f-9abababbf562</Id>
        <Name>sample string 4</Name>
        <Type>PrintingOptions</Type>
        <Value>sample string 5</Value>
        <VoucherId>3</VoucherId>
      </VoucherPropertyDto>
    </VoucherProperties>
    <VoucherUsers>
      <VoucherUserDto>
        <ApplyAutomatically>true</ApplyAutomatically>
        <SingleUse>true</SingleUse>
        <UserId>276952e5-0082-4878-9f9a-25abf3e8be4a</UserId>
      </VoucherUserDto>
      <VoucherUserDto>
        <ApplyAutomatically>true</ApplyAutomatically>
        <SingleUse>true</SingleUse>
        <UserId>276952e5-0082-4878-9f9a-25abf3e8be4a</UserId>
      </VoucherUserDto>
    </VoucherUsers>
  </Voucher>
</PayCampaignDto>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

None.