Collections

Create a collection

Changed on

Create a new collection and provide the data that you'll access from the collection or the url that you'll download CSV or JSON data from.

Note: A collection can't be larger than 10 MB, and each top-level field in a row can hold up to 10,000 characters. The total size of all collections in your account can't exceed 5 GB. Customer.io rejects a request that would take your account over that limit.

post/v1/collections

Request

  • Base URL
    https://api.customer.io
  • URL
    https://api.customer.io/v1/collections
  • Auth
    HTTP bearer

Request body

OR

Response

The collection was created successfully.

Example response

{
  "collection": {
    "bytes": 296,
    "created_at": 1552341937,
    "updated_at": 1552341937,
    "id": 1,
    "name": "upcoming events",
    "rows": 2,
    "schema": [
      "eventDate",
      "eventName",
      "presents"
    ]
  }
}

Changes