Respond.io icon

Respond.io

Read, update, write and delete data from Respond.io

Conversations → Assign or unassign a Conversation

AI-generated

Summary

Assign or unassign a conversation to a user in the Respond.io platform by specifying the contact and assignment details.

Inputs

  • Identifier Type (required) — Choose how to identify the contact: by numeric ID, email, or phone number.
  • Contact ID (required) — Provide the numeric ID of the contact when identifier type is 'Id'.
  • Contact Identifier (required) — Provide the contact's email or phone number when identifier type is 'Email' or 'Phone' respectively.
  • Assignment Type (required) — Select the type of assignment: unassign the contact, assign by user ID, or assign by user email.
  • Select User ID (required) — Specify the ID of the user to assign the conversation to (shown only if assignment type is 'Assign by User ID'). This user ID is found under Settings > Users.
  • Select User Email (required) — Specify the email of the user to assign the conversation to (shown only if assignment type is 'Assign by User Email'). This email is found under Settings > Users.

Output shape

a single updated conversation record reflecting the assignment change

The operation outputs the updated conversation data after assignment or unassignment. Errors occur if required fields are missing or invalid (e.g., contact not found or user to assign does not exist). No pagination or list returned; this is a singular update operation.

Links

Discussion