Accounts / Segments

Create Account Segment

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

You will only be able to create a Account Segment 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

AttributeTypeDescription
branchVisibilityArrayIn which Branch the Account Segment is visible
descriptionBRStringAccount Segment label in Brasilian Portuguese
descriptionDEStringAccount Segment label in German
descriptionDKStringAccount Segment label in Dutch
descriptionEN (Required)StringAccount Segment label in English
descriptionESStringAccount Segment label in Spanish
descriptionFRStringAccount Segment label in French
descriptionITStringAccount Segment label in Italian
descriptionPTStringAccount Segment label in Portuguese
descriptionRUStringAccount Segment label in Russian
descriptionUSStringAccount Segment label in American English
orderIntegerThe position of the Account Segment in the Account Segments value list
visitCycleIntegerVisit cycle linked to the value. e.g. visit every 30 days accounts in Segment A

RESPONSE

Returns a JSON with information about the Account Segment just created.

AttributeType
IdId assigned to the new Account Segment
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/accountSegments

Request

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

Headers

Acceptstring

Request body

descriptionENstring
visitCycleinteger

Response

Create Account Segment

Changes

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