Versions

• version 2
• version 1

If you need any other API functionality, please let us know at hello@customer.guru and we do our best to implement it within a few days.

You can manage your api_token and api_secret in API keys.

POST https://customer.guru/api/v2/survey

{
  "api_token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "api_secret": "yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy",
  "test": true,
  "scheduled_for": "now",
  "survey_id": null,
  "customers": [
    {
      "email": "juraj@customer.guru",
      "language": "de",
      "properties": {
        "order_count": "1",
        "zip": "12345",
        "product category": "hoodies"
      }
    },
    {
      "email": "niceapi@customer.guru",
      "properties": {
        "order_count": "2",
        "zip": "23123",
        "product category": "t-shirts"
      }
    }
  ]
}

{
  "status":"OK",
  "successfully_sent":0,
  "failed_to_send":1,
  "test":true
}

Please remove the test field if you want to actually send out email surveys.

All main object attributes (except test) are required.

scheduled_for

• now
• timestamp in the future formatted in iso8601, e.g. 2016-09-10T18:28:44Z

survey_id

• survey ID e.g. 123456
• If survey_id isn't provided, users first survey is used

each customer needs to contain

• email
• language (optional) defines the customer survey language that has a precedence over the main language setting
• properties (optional) is an arbitrary JSON with additional customer information that can be later used for segmenting your data. We suggest sending as much relevant information as possible, including order count, total order value, formatted shipping address, etc.

GET https://customer.guru/export/customers?api_secret=yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy&api_token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&page=0&per_page=50

id,email,created_at,unsubscribed_at,property_1,property_2
4766,juraj@customer.guru,2016-10-10 23:08:13 UTC,,property 1 value,property 2 value

GET https://customer.guru/export/ratings?api_secret=yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy&api_token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&page=0&per_page=50

id,email,updated_at,score,message,ip_address,city,state,country,email_sent_at,email_opened_at,email_clicked_at
45,juraj@customer.guru,2016-10-10 23:09:19 UTC,10,"Big help for my business!",8.8.8.8,"San Francisco",California,United States,2016-10-10 23:09:12 UTC,2016-10-10 23:09:12 UTC,2016-10-10 23:09:14 UTC