Create a Folder

Creates a new folder in Oracle Responsys.

Service URL:

/rest/api/v1.3/folders

Required Path Parameters:

None

Request Method:

POST

Request Header:

Authorization=<AUTH_TOKEN>

Content-Type=application/json

Request Body:

{
  "folderName": "FolderName"
}

Sample Response in case of success:

See the online REST API reference for a full list of the properties returned.

{
  "success": true,
  "folderId": 90087147,
  "errorMessage": null
}

Sample Responses in case of failure:

Invalid folder name: Requests fail if the folder name specified is invalid. The folder name must consist of the characters A-Z a-z 0-9 space ! - = @ _ [ ] { }. The error resembles:

{
  "type": "",
  "title": "Invalid request parameters",
  "errorCode": "INVALID_PARAMETER",
  "detail": "Invalid Folder Name in the Request",
  "errorDetails": []
}

Folder already exists: Requests fail if the folder name specified already exists in Responsys. The error resembles:

{
  "type": "",
  "title": "Folder already exists",
  "errorCode": "FOLDER_ALREADY_EXISTS",
  "detail": "Folder [ Folder_Name ] already exists.",
  "errorDetails": []
}

Maximum length of folder name: Requests fail if the folder name specified exceeds 100 characters. The error resembles:

{
  "type": "",
  "title": "Invalid request parameters",
  "errorCode": "INVALID_PARAMETER",
  "detail": "Max Length of folderName allowed: 100",
  "errorDetails": []
}

Insufficient role: Requests fail if the user performing the request does not have the Folder Web Services Manager role. The error resembles:

{
  "type": "",
  "title": "Insufficient access",
  "errorCode": "INSUFFICIENT_ACCESS",
  "detail": "Insufficient privileges to invoke this API",
  "errorDetails": []
}