Create Email

post/v1/emails

Creates a bare email address resource in the caller's workspace. Side effect: inserts (or, via deduplication, resolves to an existing) email row. The returned id can then be linked to a person or company.

Requires a bearer token: Authorization: Bearer <token>.

Request

cURL

curl -X POST https://api.wellapp.ai/v1/emails \
  -H "Authorization: Bearer $WELL_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "data": {
    "type": "email",
    "attributes": {
      "email": "billing@anthropic.com"
    }
  }
}'

Request body

{
  "data": {
    "type": "email",
    "attributes": {
      "email": "billing@anthropic.com"
    }
  }
}

Responses

201 — The created email resource.

{
  "data": {
    "type": "email",
    "id": "e6f7a8b9-0c1d-42e3-94f5-a6b7c8d9e0f1",
    "attributes": {
      "value": "billing@anthropic.com",
      "created_at": "2026-01-12T09:31:05.000Z",
      "updated_at": null
    },
    "relationships": {
      "company_emails": {
        "data": [
          {
            "type": "company_email",
            "id": "00000000-0000-4000-8000-000000000001"
          }
        ]
      },
      "person_emails": {
        "data": [
          {
            "type": "person_email",
            "id": "00000000-0000-4000-8000-000000000001"
          }
        ]
      }
    }
  }
}

400 — Bad Request

{
  "code": "BAD_REQUEST",
  "status": 400,
  "title": "Bad Request",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}

401 — Unauthorized

{
  "code": "UNAUTHORIZED",
  "status": 401,
  "title": "Unauthorized",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}

403 — Forbidden

{
  "code": "FORBIDDEN",
  "status": 403,
  "title": "Forbidden",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}