# Create Collection

This endpoint will allow the User to create a collection in a specific bot.

### Request

The following request will create a collection in the bot specified by the Bot Token.

```bash
curl --location --request POST 'https://<SERVICE ENDPOINT>/data/collection' \
--header 'Authorization: Bearer <BOT_AUTH_TOKEN>' \
--header 'Content-Type: application/json'
--data-raw '{ "Item":{ 
    "CollectionName":"Customer_Emails" 
    }
}'
```

### Response

If successful, the response will contain the created collection associated with bot specified in the request token.

```javascript
{
        "CollectionId": "The ID of the collection",
        "Name": "Name of the collection",
        "Fields": [{
            "Group": "Group of the Field",
            "Name": "Name of the Field",
            "Value": "Value of the Field",
            "Mandatory": boolean,
            "DisplayInView": boolean,
            "Indexed": boolean,            
            "Type": number,
            "OrderField": "The position of the field",            
        }],
    }
```

The Type property is a number that goes from 0 to 8 that specifies the Field Type.

```
Text            = 0,
LongText        = 1,
MultiChoice     = 2,
Date            = 3,
DateTime        = 4,
IntegerNumber   = 5,
DecimalNumber   = 6,
Boolean         = 7,
Upload          = 8
```

### Response Codes

This endpoint will reply with the following standard HTTP codes.

<table data-header-hidden><thead><tr><th width="276">Code</th><th>Meaning</th></tr></thead><tbody><tr><td>Code</td><td>Meaning</td></tr><tr><td>200</td><td>Ok. The request has been successfully fulfilled.</td></tr><tr><td>400</td><td>Bad Request. The supplied token is invalid or does not have enough permissions.</td></tr><tr><td>401</td><td>Unauthorized. The account associated to the token is not authorized</td></tr><tr><td>404</td><td>Not Found. The account or the chatbot specified could not be found.</td></tr></tbody></table>
