Ir al contenido principal
Contacts

Get contact email preferences by external user ID

Retrieves the email preference state for a customer contact by their external user ID.

GET
/v2/contacts/by-user-id/{userId}/email-preferences

This endpoint only supports customer contacts and mirrors the existing by-user-id lookup pattern used across the contact API.

Path Parameters

  • userId - The external user ID from your system

Example Response

{
  "object": "contact_email_preferences",
  "contactId": "676f0f6765bdaa7d7d760f88",
  "userId": "usr_12345",
  "email": "john@example.com",
  "preferences": {
    "all": {
      "status": "unsubscribed",
      "effectiveStatus": "unsubscribed"
    },
    "postUpdates": {
      "status": "subscribed",
      "effectiveStatus": "unsubscribed"
    },
    "postComments": {
      "status": "subscribed",
      "effectiveStatus": "unsubscribed"
    },
    "commentReplies": {
      "status": "subscribed",
      "effectiveStatus": "unsubscribed"
    },
    "changelog": {
      "status": "subscribed",
      "effectiveStatus": "unsubscribed"
    }
  }
}

Autorizaciones

Authorizationstringheaderobligatorio

API key as Bearer token. Use: Authorization: Bearer sk_...

Parámetros de ruta

userIdstringobligatorio

External user ID from your system

Maximum string length: 255
Ejemplo: usr_12345

Encabezados

Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Opciones disponibles: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover
Ejemplo: 2026-08-19.orbit

Respuesta

application/json

Success

contactIdstringobligatorio

Featurebase contact ID

Ejemplo: 676f0f6765bdaa7d7d760f88
emailstring | null

Contact email address, if available

Ejemplo: john@example.com
objectenum<string>obligatorio

Object type identifier

Opciones disponibles: contact_email_preferences
Ejemplo: contact_email_preferences
preferencesobjectobligatorio

Email preference state for this contact, including both stored status and final effective status.

userIdstring | null

External user ID from your system, if available

Ejemplo: usr_12345

¿Aún necesitas ayuda? Pregunta al equipo