GET
/
api
/
v3
/
touches
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"
    }
  ]
}