Campaigns / Entity

Create Campaign

This endpoint allows you to create a Campaign based on JSON input.

You will only be able to create a Campaign after first providing the Session Key. To know how you can obtain the Session Key, go to Authentication.

HEADERS

ParameterValueDescription
Content-Typeapplication/jsonLanguage in which all request and response bodies are encoded
Accept*/*Any data of whatever mime type is accepted
X-Session-KeyAUTH_TOKENThis field must be completed with the token obtained at the authentication

REQUEST BODY

AttributeTypeDescription
title (Required)StringA short descriptive name for the specific Campaign
descriptionStringA longer description of the Campaign content, it can be also HTML
videoUrlStringA link to a video that describe the sales Campaign
address2StringSecond address to whom the Campaign is linked
startDate (Required)StringDate in wich the Campaign starts
endDate (Required)StringDate when the Campaign ends
ownerId (Required)IntegerUnique identifier of the User associated to the Campaign (see Users resource)
typeId (Required)IntegerType of the Campaign (see Types resource)
statusId (Required)IntegerStatus of the Campaign (see Statues resource)

RESPONSE

Returns a JSON with information about the Campaign just created.

AttributeType
IdId assigned to the new Campaign
MessageThe operation status

RESPONSE CODES

StatusDescription
200 OKShows if operation succeeded
400 Bad RequestShows when an invalid request or the requested service is not available
post/campaigns

Request

  • Base URL: https://api.forcemanager.com/api/v4
  • URL: https://api.forcemanager.com/api/v4/campaigns
  • Auth: API key in header X-Session-Key

Headers

Acceptstring

Request body

titlestring
descriptionstring
ownerIdinteger
statusIdinteger
typeIdinteger
startDatestring
endDatestring
deletedboolean
videoUrlstring

Response

Create Campaign

Changes

No recorded changes to this operation across all 1 revision of this API.