Usuarios

GET /v1/users lista a las personas de tu empresa. Existe por una razón práctica: que tu integración pueda ofrecer un selector de "enviar como" en lugar de fijar un único remitente en el código, y después pasar el correo de la persona elegida como sender_email al enviar.

Requiere el scope users:read. Es de solo lectura: no hay ningún endpoint para invitar, modificar ni eliminar un miembro.

Parámetros de consulta

Ejemplo de petición

curl "https://api2.bunnydoc.com/v1/users?status=accepted&per_page=100" \
  -H "Authorization: Bearer <access_token>"

GET /v1/users?status=accepted&per_page=100 HTTP/1.1
Host: api2.bunnydoc.com
Authorization: Bearer <access_token>

Respuesta

{
  "data": [
    {
      "id": "018f6b2c-3d4e-7f5a-8b6c-7d8e9f0a1b2c",
      "email": "dana@yourco.com",
      "first_name": "Dana",
      "surname": "Lee",
      "name": "Dana Lee",
      "role": "admin",
      "status": "accepted",
      "products": ["eSign"]
    }
  ],
  "pagination": { "page": 1, "per_page": 25, "total": 1, "total_pages": 1 }
}

Elegir un remitente válido

No todos los de la lista pueden enviar. Para que sender_email resuelva, el miembro debe cumplir las dos condiciones:

• status = accepted — una invitación pendiente o un miembro archivado no es un usuario activo, y
• tener un asiento de eSign — comprueba que products contiene eSign.

Filtra por ambas antes de ofrecer a alguien en un selector:

const res = await fetch(
  "https://api2.bunnydoc.com/v1/users?status=accepted&per_page=100",
  { headers: { Authorization: `Bearer ${token}` } },
);
const { data } = await res.json();

const senders = data.filter((u) => u.products.includes("eSign"));

Cualquier otro caso te da 422 sender_not_found en el momento del envío.

Hay un caso del que esta lista no puede avisarte: un miembro puede tener la pertenencia accepted mientras su cuenta de usuario está desactivada. Eso no se expone aquí, así que trata un 422 sender_not_found sobre un miembro que por lo demás cumple los requisitos como "esta persona ya no puede enviar" y recurre a otro remitente o al propietario de la clave.

Errores

Siguientes pasos