# Quo

> Manage Quo contacts and notes, send text messages, read conversations, messages and calls, download call recordings and transcripts, and track tasks.

App · 25 actions. Web page: https://docs.lodol.com/docs/integrations/quo

## Actions

### Create contact

Create a contact.

**Inputs**

- First name (`first_name`, text, required): The first name of the contact.
- Last name (`last_name`, text): The last name of the contact.
- Company (`company`, text): The company of the contact.
- Role (`role`, text): The role of the contact.
- External id (`external_id`, text): The external ID of the contact.
- Source (`source`, text): The source of the contact.
- Source url (`source_url`, text): A link to the contact in the source system.
- Actor (`actor_id`, text): The actor ID to attribute contact creation to. Defaults to the organization owner.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}
```

### Create contact note

Create a contact note.

**Inputs**

- Contact id (`contact_id`, text, required): The unique identifier of the contact whose notes are being listed.
- Text (`text`, text, required): The body of the note. Mentions using the @USxxx / @GRxxx / @ORxxx tag syntax are automatically detected and resolved.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}
```

### Delete contact

Delete a contact.

**Inputs**

- Contact id (`contact_id`, text, required): The unique identifier of the contact to delete.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}
```

### Delete contact note

Delete a contact note.

**Inputs**

- Contact id (`contact_id`, text, required): The unique identifier of the contact the note belongs to.
- Note id (`note_id`, text, required): The unique identifier of the note to delete.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}
```

### Get call

Get a call by ID.

**Inputs**

- Call id (`call_id`, text, required): Unique identifier of the call.
- Include (`include`, list): Comma-separated list of optional payload sections to include. `summary` adds the call’s summary, `voicemail` the voicemail left on it. Omitted sections are left out of the response entirely, and `voicemail` is also left out for a call where none was left. One or more of: `summary`, `voicemail`.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}
```

### Get contact

Get a contact by ID.

**Inputs**

- Contact id (`contact_id`, text, required): The unique identifier of the contact being retrieved.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}
```

### Get contact note

Get a contact note by ID.

**Inputs**

- Contact id (`contact_id`, text, required): The unique identifier of the contact the note belongs to.
- Note id (`note_id`, text, required): The unique identifier of the note to retrieve.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}
```

### Get message

Get a message by ID.

**Inputs**

- Message id (`message_id`, text, required): The unique identifier of the message.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}
```

### Get organization

Get the organization.

**Inputs**: None.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}
```

### Get phone number

Get a phone number by ID.

**Inputs**

- Phone number (`phone_number_id`, text, required): The unique identifier of the phone number being referenced (used).
- Include (`include`, list): Comma-separated list of optional payload sections to include. `restrictions` adds the number’s calling and messaging restrictions. `businessHours` adds the number’s business hours: whether they are enforced, their timezone, and the window for each day; with nothing stored, `enabled` is `false`, `timezone` is `America/Los_Angeles` and the schedule is `null`. `businessHours` is only available on this endpoint, not on the list. Omitted sections are left out of the response entirely. The members assigned to a number are their own endpoint, `GET /phone-numbers/{phoneNumberId}/users`. One or more of: `restrictions`, `businessHours`.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}
```

### Get task

Get a task by task ID.

**Inputs**

- Task id (`task_id`, text, required): The unique identifier of the task.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}
```

### Get user

Get a user by ID.

**Inputs**

- Quo user (`quo_user_id`, text, required): The unique identifier of the user being retrieved.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}
```

### List call recordings

List recordings for a call.

**Inputs**

- Call id (`call_id`, text, required): The unique identifier of the call whose recordings are being listed.
- Limit (`limit`, number): Max number of items to return per page. From 1 to 50.
- After (`after`, text): The after.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": [],
    "nextCursor": null
  }
}
```

### List call transcripts

List transcripts for a call.

**Inputs**

- Call id (`call_id`, text, required): The unique identifier of the call whose transcripts are being listed.
- Limit (`limit`, number): Max number of items to return per page. From 1 to 50.
- After (`after`, text): The after.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": [],
    "nextCursor": null
  }
}
```

### List calls

List calls.

**Inputs**

- Include (`include`, list): Comma-separated list of optional payload sections to include. `summary` adds the call’s summary, `voicemail` the voicemail left on it. Omitted sections are left out of the response entirely, and `voicemail` is also left out for a call where none was left. One or more of: `summary`, `voicemail`.
- Phone number (`phone_number_id`, text): Only return calls on this Quo number.
- Actor (`actor_id`, text): Only return calls belonging to this Quo user or system actor. An AI agent is a system actor, so its calls are reached with its `SYU` id.
- Participant (`participant`, text): Only return calls whose own originating or receiving number is this E.164 number, such as `participant=+15555555555`. To match any of several numbers, use `participant[in]=+15555555555,+15555555556`. Note that this is narrower than the `participants` array in the response: a party who joined a group call beyond those two numbers is listed in the response but is not matched by this filter.
- Direction (`direction`, text): The direction of the call relative to the Quo number. One of: `incoming`, `outgoing`.
- Status (`status`, text): Only return calls with this status, such as `status=missed`. To match any of several statuses, use `status[in]=missed,no-answer`. One of: `queued`, `initiated`, `ringing`, `in-progress`, `completed`, `busy`, `failed`, `no-answer`, `canceled`, `missed`, and 3 more.
- Created at gte (`created_at_gte`, date and time): Only return calls created at or after this timestamp. The bound is inclusive.
- Created at lte (`created_at_lte`, date and time): Only return calls created at or before this timestamp. The bound is inclusive.
- Limit (`limit`, number): Max number of items to return per page. From 1 to 50.
- After (`after`, text): The after.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": [],
    "nextCursor": null
  }
}
```

### List contact notes

List notes for a contact.

**Inputs**

- Contact id (`contact_id`, text, required): The unique identifier of the contact whose notes are being listed.
- Limit (`limit`, number): Max number of items to return per page. From 1 to 50.
- After (`after`, text): The after.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": [],
    "nextCursor": null
  }
}
```

### List contacts

List contacts.

**Inputs**

- External id (`external_id`, text): Filter by external ID, such as `externalId=ext-1`. To match any of several, use `externalId[in]=ext-1,ext-2`.
- Source (`source`, text): Filter by source label, such as `source=openphone-hubspot`. To match any of several, use `source[in]=openphone-hubspot,openphone-salesforce`.
- Limit (`limit`, number): Page size. From 1 to 50.
- After (`after`, text): The after.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": [],
    "nextCursor": null
  }
}
```

### List conversations

List conversations.

**Inputs**

- Phone number (`phone_number_id`, text): Only return conversations on this Quo phone number ID, such as `phoneNumberId=PN123abc`. To match any of several, use `phoneNumberId[in]=PN123abc,PN456def` (max 100). Matches the Quo phone number only, not participant numbers.
- Created at gte (`created_at_gte`, date and time): The created at gte.
- Created at lte (`created_at_lte`, date and time): The created at lte.
- Updated at gte (`updated_at_gte`, date and time): The updated at gte.
- Updated at lte (`updated_at_lte`, date and time): The updated at lte.
- Sort (`sort`, text): A single field:direction pair. Allowed fields: createdAt, updatedAt. Direction must be asc or desc. One of: `createdAt:desc`, `createdAt:asc`, `updatedAt:desc`, `updatedAt:asc`.
- Limit (`limit`, number): Max number of items to return per page. From 1 to 50.
- After (`after`, text): The after.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": [],
    "nextCursor": null
  }
}
```

### List messages

List messages.

**Inputs**

- From number (`from_number`, text): A phone number in E.164 format, a short code (3-8 digits), or a non-phone-number caller ID (Anonymous, Restricted, or Blocked).
- To (`to`, text): A phone number in E.164 format, a short code (3-8 digits), or a non-phone-number caller ID (Anonymous, Restricted, or Blocked).
- Status (`status`, text): The status of the message. One of: `queued`, `sent`, `delivered`, `undelivered`, `received`, `failed`.
- Direction (`direction`, text): The direction of the message relative to the Quo number. One of: `incoming`, `outgoing`.
- Phone number (`phone_number_id`, text): The phone number id.
- Quo user (`quo_user_id`, text): The user id.
- Created at gt (`created_at_gt`, date and time): The created at gt.
- Created at lt (`created_at_lt`, date and time): The created at lt.
- Limit (`limit`, number): Max number of items to return per page. From 1 to 50.
- After (`after`, text): The after.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": [],
    "nextCursor": null
  }
}
```

### List phone numbers

List phone numbers.

**Inputs**

- Limit (`limit`, number): Max number of items to return per page. From 1 to 50.
- After (`after`, text): The after.
- Phone number (`phone_number`, text): Filter results to the phone number matching this E.164 value.
- Include (`include`, list): Comma-separated list of optional payload sections to include. `restrictions` adds the number’s calling and messaging restrictions. Omitted sections are left out of the response entirely. The members assigned to a number are their own endpoint, `GET /phone-numbers/{phoneNumberId}/users`. One or more of: `restrictions`.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": [],
    "nextCursor": null
  }
}
```

### List tasks

List tasks.

**Inputs**

- Limit (`limit`, number): Max number of items to return per page. From 1 to 100.
- After (`after`, text): The after.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": [],
    "nextCursor": null
  }
}
```

### List users

List users.

**Inputs**

- Limit (`limit`, number): Max number of items to return per page. From 1 to 50.
- After (`after`, text): The after.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": [],
    "nextCursor": null
  }
}
```

### Send text message

Send a real text message from your number to up to ten recipients. Uses the documented v1 messaging endpoint; carrier registration and messaging charges may apply.

**Inputs**

- Sender (`sender`, text, required): Select your Quo number or enter its number in international format.
- Recipients (`recipients`, list, required): Recipient phone numbers in international format, such as +14155552671.
- Content (`content`, text, required): The message text, up to 1600 characters.
- Quo user (`quo_user_id`, text): Send as this user. Leave empty to use the phone number owner.
- Inbox status (`inbox_status`, text): Move the related conversation to Done. Leave empty to keep the default inbox behavior. One of: `done`.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "id": "AC123",
      "status": "queued",
      "text": "Hello"
    }
  }
}
```

### Update contact

Update a contact by ID.

**Inputs**

- Contact id (`contact_id`, text, required): The unique identifier of the contact being updated.
- First name (`first_name`, text): The first name of the contact.
- Last name (`last_name`, text): The last name of the contact.
- Company (`company`, text): The company of the contact.
- Role (`role`, text): The role of the contact.
- External id (`external_id`, text): The external ID of the contact.
- Source (`source`, text): The source of the contact.
- Source url (`source_url`, text): The source URL of the contact.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}
```

### Update contact note

Update a contact note.

**Inputs**

- Contact id (`contact_id`, text, required): The unique identifier of the contact the note belongs to.
- Note id (`note_id`, text, required): The unique identifier of the note to update.
- Text (`text`, text, required): The updated body of the note.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}
```
