Create new segment folder

Request

Create a new parent segment folder.

Security

TdApikeyAuth

Path

audienceIdinteger, (int64)required

Master segment ID

Bodyapplication/json

Segment Folder to create

namestringrequired

descriptionstringrequired

curl -i -X POST \
  'https://api-cdp.treasuredata.com/audiences/{audienceId}/folders' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "description": "string"
  }'

Responses

Returns the segment folder which was created

Bodyapplication/json

idstring[1-9][0-9]*

audienceIdstring[1-9][0-9]*

ID of the parent audience. For composable folders this carries the composable audience id; the complete-vs-composable discriminator lives on the parent audience entity, not on the folder.

namestring

descriptionstring or null

createdAtstring, (date-time)

updatedAtstring, (date-time)

createdByUser (object) or (NullValue (object or null))

One of:

updatedByUser (object) or (NullValue (object or null))

One of:

Response

{
  "id": "string",
  "audienceId": "string",
  "name": "string",
  "description": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "createdBy": {
    "id": "string",
    "td_user_id": "string",
    "name": "string"
  },
  "updatedBy": {
    "id": "string",
    "td_user_id": "string",
    "name": "string"
  }
}