# Wootric

> Work with your Wootric (InMoment NPS) customer feedback: read the NPS summary, find, add, change and delete end users, list, record and delete their responses and declines, and manage their survey settings.

App · 18 actions. Web page: https://docs.lodol.com/docs/integrations/wootric

## Actions

### Add end user

Add a person to Wootric by email, with your own id and properties, so they can be surveyed or have responses recorded.

**Inputs**

- Email (`email`, text, required): The person's email address.
- External ID (`external_id`, text): Your own id for this person, such as a customer id.
- Last surveyed (`last_surveyed`, date and time): When this person was last surveyed, if elsewhere.
- Customer since (`external_created_at`, date and time): When this person became your customer or user.
- Properties (`properties`, object): Your own details about the end user to segment results by, such as {"plan": "Pro"}. Keys and values are kept as given.

**Outputs**

- `end_user` (object): The end user

**Example output**

```json
{
  "end_user": {
    "created_at": "2026-10-01T09:00:00.000Z",
    "email": "jo@example.com",
    "external_created_at": "2026-01-05T09:00:00.000Z",
    "external_id": "cust-77",
    "id": 4012,
    "last_response": {
      "id": 9001,
      "score": 9,
      "survey": {},
      "text": "Great"
    },
    "last_seen_at": null,
    "last_surveyed": "2026-09-20T09:00:00.000Z",
    "phone_number": null,
    "properties": {
      "plan": "Pro"
    },
    "settings": {
      "email_nps": true,
      "force_mobile_survey": false,
      "force_web_survey": false,
      "mobile_nps": true,
      "surveys_disabled_by_end_user": false,
      "web_nps": true
    },
    "updated_at": "2026-10-01T09:00:00.000Z"
  }
}
```

### Delete decline

Delete a recorded decline.

**Inputs**

- End user ID (`end_user_id`, text, required): Wootric's id for the end user, from 'Find end users', 'Add end user' or an earlier step.
- Decline ID (`decline_id`, text, required): The decline's id, from 'List declines' or 'Record decline'.

**Outputs**

- `decline_id` (text): The decline deleted
- `deleted` (true/false): Always true once deleted

**Example output**

```json
{
  "decline_id": "3301",
  "deleted": true
}
```

### Delete end user

Mark an end user and their responses for deletion. Wootric removes them at 7 AM UTC the next day.

**Inputs**

- End user ID (`end_user_id`, text, required): Wootric's id for the end user, from 'Find end users', 'Add end user' or an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `end_user_id` (text): The end user deleted

**Example output**

```json
{
  "deleted": true,
  "end_user_id": "4012"
}
```

### Delete response

Delete a response so it no longer counts towards the NPS.

**Inputs**

- End user ID (`end_user_id`, text, required): Wootric's id for the end user, from 'Find end users', 'Add end user' or an earlier step.
- Response ID (`response_id`, text, required): The response's id, from 'List responses' or 'Record response'.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `response_id` (text): The response deleted

**Example output**

```json
{
  "deleted": true,
  "response_id": "9001"
}
```

### Find end users

List the people Wootric surveys, optionally filtered by email, when they were created or updated, or whether a survey channel is turned off for them. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Email (`email`, text): Only the end user with this email address.
- Created after (`created_after`, date and time): Only records created after this date and time.
- Created before (`created_before`, date and time): Only records created before this date and time.
- Updated after (`updated_after`, date and time): Only records updated after this date and time.
- Updated before (`updated_before`, date and time): Only records updated before this date and time.
- Only people with a survey channel off (`surveys_disabled`, true/false): Only end users with at least one survey channel (email, website or mobile app) turned off.
- Sort by (`sort_key`, text): What to sort by. Defaults to email. One of: `email` (Email (default)), `created_at` (Date created), `updated_at` (Date updated).
- Order (`sort_order`, text): Defaults to ascending. One of: `asc` (Ascending (default)), `desc` (Descending).
- Page (`page`, number): Which page to get, 1 to 30. Defaults to the first. From 1 to 30.
- Page size (`per_page`, number): How many to return per page, 1 to 50. Wootric's default is 25. From 1 to 50.

**Outputs**

- `count` (number): How many came back on this page
- `end_users` (list): The end users
- `next_page` (number): The page number to ask for next, or 0 when there are no more
- `page` (number): The page number returned

**Example output**

```json
{
  "count": 1,
  "end_users": [
    {
      "created_at": "2026-10-01T09:00:00.000Z",
      "email": "jo@example.com",
      "external_created_at": "2026-01-05T09:00:00.000Z",
      "external_id": "cust-77",
      "id": 4012,
      "last_response": {
        "id": 9001,
        "score": 9,
        "survey": {},
        "text": "Great"
      },
      "last_seen_at": null,
      "last_surveyed": "2026-09-20T09:00:00.000Z",
      "phone_number": null,
      "properties": {
        "plan": "Pro"
      },
      "settings": {
        "email_nps": true,
        "force_mobile_survey": false,
        "force_web_survey": false,
        "mobile_nps": true,
        "surveys_disabled_by_end_user": false,
        "web_nps": true
      },
      "updated_at": "2026-10-01T09:00:00.000Z"
    }
  ],
  "next_page": 0,
  "page": 1
}
```

### Get decline

Get one decline with its date and the page it happened on.

**Inputs**

- End user ID (`end_user_id`, text, required): Wootric's id for the end user, from 'Find end users', 'Add end user' or an earlier step.
- Decline ID (`decline_id`, text, required): The decline's id, from 'List declines' or 'Record decline'.

**Outputs**

- `decline` (object): The decline

**Example output**

```json
{
  "decline": {
    "created_at": "2026-10-02T09:05:00.000Z",
    "end_user": {
      "properties": {
        "plan": "Pro"
      }
    },
    "end_user_id": 4012,
    "id": 3301,
    "ip_address": "203.0.113.5",
    "origin_url": "https://example.com/app",
    "survey_id": 12,
    "updated_at": "2026-10-02T09:05:00.000Z"
  }
}
```

### Get end user

Get one end user by Wootric id, email, external id or phone number, with their properties, last response and survey settings.

**Inputs**

- End user (`identifier`, text, required): The end user's Wootric id, email, external id or phone number, matching 'Look up by'. A phone number starts with + and the country code.
- Look up by (`lookup_by`, text): What the value above is. Defaults to Wootric's id. One of: `id` (Wootric ID (default)), `email` (Email address), `external_id` (External ID), `phone_number` (Phone number).

**Outputs**

- `end_user` (object): The end user

**Example output**

```json
{
  "end_user": {
    "created_at": "2026-10-01T09:00:00.000Z",
    "email": "jo@example.com",
    "external_created_at": "2026-01-05T09:00:00.000Z",
    "external_id": "cust-77",
    "id": 4012,
    "last_response": {
      "id": 9001,
      "score": 9,
      "survey": {},
      "text": "Great"
    },
    "last_seen_at": null,
    "last_surveyed": "2026-09-20T09:00:00.000Z",
    "phone_number": null,
    "properties": {
      "plan": "Pro"
    },
    "settings": {
      "email_nps": true,
      "force_mobile_survey": false,
      "force_web_survey": false,
      "mobile_nps": true,
      "surveys_disabled_by_end_user": false,
      "web_nps": true
    },
    "updated_at": "2026-10-01T09:00:00.000Z"
  }
}
```

### Get end user survey settings

Get which channels (email, website, mobile app) an end user may be surveyed through.

**Inputs**

- End user ID (`end_user_id`, text, required): Wootric's id for the end user, from 'Find end users', 'Add end user' or an earlier step.

**Outputs**

- `settings` (object): The end user's survey settings

**Example output**

```json
{
  "settings": {
    "created_at": "2026-10-01T09:00:00.000Z",
    "email_nps": true,
    "end_user_id": 4012,
    "force_mobile_survey": false,
    "force_web_survey": false,
    "id": 551,
    "mobile_nps": true,
    "updated_at": "2026-10-01T09:00:00.000Z",
    "web_nps": true
  }
}
```

### Get NPS summary

Get the Net Promoter Score for a date range, with how many promoters, passives and detractors answered and the response rates. Wootric uses the last month when no dates are given.

**Inputs**

- From (`start_date`, date): First day to include. Wootric defaults to the last month.
- Until (`end_date`, date): Last day to include, in your account's time zone.

**Outputs**

- `summary` (object): The summary

**Example output**

```json
{
  "summary": {
    "detractors": 18,
    "email_response_rate": 12.1,
    "nps": 42,
    "passives": 30,
    "promoters": 72,
    "response_rate": 24.5,
    "responses": 120
  }
}
```

### Get response

Get one response with its score, comment, tags and date.

**Inputs**

- End user ID (`end_user_id`, text, required): Wootric's id for the end user, from 'Find end users', 'Add end user' or an earlier step.
- Response ID (`response_id`, text, required): The response's id, from 'List responses' or 'Record response'.

**Outputs**

- `response` (object): The response

**Example output**

```json
{
  "response": {
    "completed": true,
    "created_at": "2026-10-01T09:05:00.000Z",
    "end_user": {
      "properties": {
        "plan": "Pro"
      }
    },
    "end_user_id": 4012,
    "excluded_from_calculations": false,
    "id": 9001,
    "ip_address": "203.0.113.5",
    "origin_url": "https://example.com/app",
    "score": 9,
    "survey_id": 12,
    "tags": [
      "pricing"
    ],
    "text": "Great product",
    "updated_at": "2026-10-01T09:05:00.000Z"
  }
}
```

### List declines

List the times people dismissed the survey, for the whole account or one end user. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- End user ID (`end_user_id`, text): Only this end user's records. Leave empty for the whole account. Wootric's id, from 'Find end users' or an earlier step.
- Created after (`created_after`, date and time): Only records created after this date and time.
- Created before (`created_before`, date and time): Only records created before this date and time.
- Updated after (`updated_after`, date and time): Only records updated after this date and time.
- Updated before (`updated_before`, date and time): Only records updated before this date and time.
- Sort by (`sort_key`, text): What to sort by. Defaults to the date created. One of: `created_at` (Date created (default)), `updated_at` (Date updated).
- Order (`sort_order`, text): Defaults to newest first. One of: `desc` (Newest first (default)), `asc` (Oldest first).
- Page (`page`, number): Which page to get, 1 to 30. Defaults to the first. From 1 to 30.
- Page size (`per_page`, number): How many to return per page, 1 to 50. Wootric's default is 25. From 1 to 50.

**Outputs**

- `count` (number): How many came back on this page
- `declines` (list): The declines
- `next_page` (number): The page number to ask for next, or 0 when there are no more
- `page` (number): The page number returned

**Example output**

```json
{
  "count": 1,
  "declines": [
    {
      "created_at": "2026-10-02T09:05:00.000Z",
      "end_user": {
        "properties": {
          "plan": "Pro"
        }
      },
      "end_user_id": 4012,
      "id": 3301,
      "ip_address": "203.0.113.5",
      "origin_url": "https://example.com/app",
      "survey_id": 12,
      "updated_at": "2026-10-02T09:05:00.000Z"
    }
  ],
  "next_page": 0,
  "page": 1
}
```

### List responses

List NPS responses for the whole account or one end user, filtered by date or, for one end user, by promoter, passive or detractor. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- End user ID (`end_user_id`, text): Only this end user's records. Leave empty for the whole account. Wootric's id, from 'Find end users' or an earlier step.
- Which responses (`sentiment`, text): Split by score: promoters, passives or detractors. Needs an end user ID, since Wootric splits them only for one end user. One of: `all` (All responses (default)), `promoters` (Promoters (9 to 10)), `passives` (Passives (7 to 8)), `detractors` (Detractors (0 to 6)).
- Created after (`created_after`, date and time): Only records created after this date and time.
- Created before (`created_before`, date and time): Only records created before this date and time.
- Updated after (`updated_after`, date and time): Only records updated after this date and time.
- Updated before (`updated_before`, date and time): Only records updated before this date and time.
- Sort by (`sort_key`, text): What to sort by. Defaults to the date created. One of: `created_at` (Date created (default)), `updated_at` (Date updated).
- Order (`sort_order`, text): Defaults to newest first. One of: `desc` (Newest first (default)), `asc` (Oldest first).
- Page (`page`, number): Which page to get, 1 to 30. Defaults to the first. From 1 to 30.
- Page size (`per_page`, number): How many to return per page, 1 to 50. Wootric's default is 25. From 1 to 50.

**Outputs**

- `count` (number): How many came back on this page
- `next_page` (number): The page number to ask for next, or 0 when there are no more
- `page` (number): The page number returned
- `responses` (list): The responses

**Example output**

```json
{
  "count": 1,
  "next_page": 0,
  "page": 1,
  "responses": [
    {
      "completed": true,
      "created_at": "2026-10-01T09:05:00.000Z",
      "end_user": {
        "properties": {
          "plan": "Pro"
        }
      },
      "end_user_id": 4012,
      "excluded_from_calculations": false,
      "id": 9001,
      "ip_address": "203.0.113.5",
      "origin_url": "https://example.com/app",
      "score": 9,
      "survey_id": 12,
      "tags": [
        "pricing"
      ],
      "text": "Great product",
      "updated_at": "2026-10-01T09:05:00.000Z"
    }
  ]
}
```

### List segments

List the segments Wootric tracks: the end user property names you can break results down by, with their types.

**Inputs**: None.

**Outputs**

- `count` (number): How many segments
- `segments` (list): The segments

**Example output**

```json
{
  "count": 1,
  "segments": [
    {
      "created_at": "2026-01-05T09:00:00.000Z",
      "data_type": "string",
      "name": "plan"
    }
  ]
}
```

### List survey templates

List the account's survey templates with their languages, and which one is the default.

**Inputs**: None.

**Outputs**

- `count` (number): How many templates
- `default_survey_template_id` (number): The default template's id, 0 if none
- `survey_templates` (list): The survey templates

**Example output**

```json
{
  "count": 1,
  "default_survey_template_id": 7,
  "survey_templates": [
    {
      "custom_samplings": {},
      "default_language": "en",
      "id": 7,
      "languages": [
        {
          "code": "en",
          "name": "English"
        }
      ],
      "name": "Default NPS survey",
      "non_configured_language_count": 0
    }
  ]
}
```

### Record decline

Record that an end user dismissed the survey without answering, so Wootric counts it in the response rate.

**Inputs**

- End user ID (`end_user_id`, text, required): Wootric's id for the end user, from 'Find end users', 'Add end user' or an earlier step.
- Page address (`origin_url`, text): The address of the page the person dismissed the survey on.
- Declined at (`created_at`, date and time): When the person declined. Defaults to now.
- Properties (`properties`, object): Your own details about the end user to segment results by, such as {"plan": "Pro"}. Keys and values are kept as given.

**Outputs**

- `decline` (object): The decline

**Example output**

```json
{
  "decline": {
    "created_at": "2026-10-02T09:05:00.000Z",
    "end_user": {
      "properties": {
        "plan": "Pro"
      }
    },
    "end_user_id": 4012,
    "id": 3301,
    "ip_address": "203.0.113.5",
    "origin_url": "https://example.com/app",
    "survey_id": 12,
    "updated_at": "2026-10-02T09:05:00.000Z"
  }
}
```

### Record response

Record an NPS response for an end user: a score from 0 to 10 and optionally their comment. Use it to bring in answers collected somewhere else.

**Inputs**

- End user ID (`end_user_id`, text, required): Wootric's id for the end user, from 'Find end users', 'Add end user' or an earlier step.
- Score (`score`, number, required): The 0 to 10 likelihood-to-recommend score. From 0 to 10.
- Comment (`text`, text): What the person said about their score.
- Page address (`origin_url`, text, required): The address of the page the person answered on.
- IP address (`ip_address`, text): The IP address the response came from.
- Answered at (`created_at`, date and time): When the person answered. Defaults to now.
- Properties (`properties`, object): Your own details about the end user to segment results by, such as {"plan": "Pro"}. Keys and values are kept as given.

**Outputs**

- `response` (object): The response

**Example output**

```json
{
  "response": {
    "completed": true,
    "created_at": "2026-10-01T09:05:00.000Z",
    "end_user": {
      "properties": {
        "plan": "Pro"
      }
    },
    "end_user_id": 4012,
    "excluded_from_calculations": false,
    "id": 9001,
    "ip_address": "203.0.113.5",
    "origin_url": "https://example.com/app",
    "score": 9,
    "survey_id": 12,
    "tags": [
      "pricing"
    ],
    "text": "Great product",
    "updated_at": "2026-10-01T09:05:00.000Z"
  }
}
```

### Update end user

Change an end user's email, external id, dates or properties. Only the fields given change.

**Inputs**

- End user ID (`end_user_id`, text, required): Wootric's id for the end user, from 'Find end users', 'Add end user' or an earlier step.
- Email (`email`, text): A new email address. Leave empty to keep it.
- External ID (`external_id`, text): Your own id for this person, such as a customer id.
- Last surveyed (`last_surveyed`, date and time): When this person was last surveyed, if elsewhere.
- Customer since (`external_created_at`, date and time): When this person became your customer or user.
- Properties (`properties`, object): Your own details about the end user to segment results by, such as {"plan": "Pro"}. Keys and values are kept as given.

**Outputs**

- `end_user` (object): The end user

**Example output**

```json
{
  "end_user": {
    "created_at": "2026-10-01T09:00:00.000Z",
    "email": "jo@example.com",
    "external_created_at": "2026-01-05T09:00:00.000Z",
    "external_id": "cust-77",
    "id": 4012,
    "last_response": {
      "id": 9001,
      "score": 9,
      "survey": {},
      "text": "Great"
    },
    "last_seen_at": null,
    "last_surveyed": "2026-09-20T09:00:00.000Z",
    "phone_number": null,
    "properties": {
      "plan": "Pro"
    },
    "settings": {
      "email_nps": true,
      "force_mobile_survey": false,
      "force_web_survey": false,
      "mobile_nps": true,
      "surveys_disabled_by_end_user": false,
      "web_nps": true
    },
    "updated_at": "2026-10-01T09:00:00.000Z"
  }
}
```

### Update end user survey settings

Turn survey channels on or off for one end user, or force a survey on their next visit. Settings left as they are do not change.

**Inputs**

- End user ID (`end_user_id`, text, required): Wootric's id for the end user, from 'Find end users', 'Add end user' or an earlier step.
- Email surveys (`email_nps`, text): Whether this person can be surveyed by email. One of: `unchanged` (Leave as it is (default)), `on`, `off`.
- Website surveys (`web_nps`, text): Whether this person can be surveyed on your website. One of: `unchanged` (Leave as it is (default)), `on`, `off`.
- Mobile app surveys (`mobile_nps`, text): Whether this person can be surveyed in your mobile app. One of: `unchanged` (Leave as it is (default)), `on`, `off`.
- Show the website survey next visit (`force_web_survey`, text): Show the website survey on this person's next visit. One of: `unchanged` (Leave as it is (default)), `on`, `off`.
- Show the mobile survey next visit (`force_mobile_survey`, text): Show the mobile app survey on this person's next visit. One of: `unchanged` (Leave as it is (default)), `on`, `off`.

**Outputs**

- `settings` (object): The end user's survey settings

**Example output**

```json
{
  "settings": {
    "created_at": "2026-10-01T09:00:00.000Z",
    "email_nps": false,
    "end_user_id": 4012,
    "force_mobile_survey": false,
    "force_web_survey": false,
    "id": 551,
    "mobile_nps": true,
    "updated_at": "2026-10-01T09:00:00.000Z",
    "web_nps": true
  }
}
```
