Accounts / Segments

Update Account Segment

This endpoint allows you to update a specific Account Segment. If the specified Account Segment does not exist, the response will be a "bad request".

You will only be able to update an 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

This endpoint allows updating the information of a specific Account Segment. In order to update an Account Segment, you just have to specify the attributes you want to modify and complete with the up to date information. It is not necessary to send all attributes.

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
descriptionENStringAccount 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 updated.

AttributeDescription
MessageShows the operation status

RESPONSE CODES

StatusDescription
200 OKShows if operation succeeded
400 Bad RequestShows when an invalid request or the requested service is not available
put/accountSegments/{ID}

Request

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

Headers

Acceptstring

Request body

visitCycleinteger

Response

Update Account Segment

Changes

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