GET
/
api
/
v3
/
touches
Get All Campaigns
curl --request GET \
  --url https://app.staging.sendo.so/api/v3/touches \
  --header 'Authorization: Bearer <token>'
{
  "current_page": 1,
  "per_page": 1,
  "total_posts": 5,
  "touches": [
    {
      "id": 123456,
      "name": "Sendoso Gift",
      "start_date": "2023-10-25T00:00:00.000-07:00",
      "end_date": null,
      "description": "",
      "created_at": "2023-10-25T05:21:59.000-07:00",
      "user_id": 78901,
      "gift_id": 39,
      "starting_egift_price": null,
      "ending_egift_price": null,
      "status": "Active",
      "is_default_price": true,
      "delivery_type": "mail",
      "hubspot_key": null,
      "ship_to_countries": ["US", "ES", "CA"],
      "currency": "USD"
    }
  ]
}

Parameters

page
integer
The page number of the results you want to retrieve (the first page is 1). See Pagination for more information.
per_page
integer
The number of campaigns to be returned per page (max is 100). See Pagination for more information.
delivery_type
string
Optional parameter to filter the results by the gift type. Valid options are mail which returns all physical item campaigns or email which returns all eGift campaigns.

Response

current_page
integer
required
The current page being returned (used for pagination purposes).
per_page
integer
required
The number of results being returned per page (used for pagination purposes).
total_posts
integer
required
The total number of campaigns (used for pagination purposes).
touches
array
required
List of campaigns
{
  "current_page": 1,
  "per_page": 1,
  "total_posts": 5,
  "touches": [
    {
      "id": 123456,
      "name": "Sendoso Gift",
      "start_date": "2023-10-25T00:00:00.000-07:00",
      "end_date": null,
      "description": "",
      "created_at": "2023-10-25T05:21:59.000-07:00",
      "user_id": 78901,
      "gift_id": 39,
      "starting_egift_price": null,
      "ending_egift_price": null,
      "status": "Active",
      "is_default_price": true,
      "delivery_type": "mail",
      "hubspot_key": null,
      "ship_to_countries": ["US", "ES", "CA"],
      "currency": "USD"
    }
  ]
}