Attest a consent grant

POST/v1/consent

Records a consent grant your brand attests to; for example, an opt-in collected on your website.

Requirements

Your brand’s consent_mode must be brand_attested. Otherwise the call returns HTTP 409 code 2014. Read your mode before building against this endpoint: GET /v1/settings reports it as consent_mode.
No Idempotency-Key: the server neither requires nor consults one here.

Behavior

Grants only. Revocations are never attested through this endpoint: an opt-out is honored in the channel where the customer expressed it.

Body ParametersJSONExpand Collapse

One of the following:

ReturnsExpand Collapse

One of the following:

Attest a consent grant

curl https://messages.api.linqapp.com/v1/consent \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $LINQ_AMB_API_KEY" \
    -d '{
          "category": "marketing",
          "source": "website",
          "subject": "urn:mbid:AQAAY7c1"
        }'

{
  "ok": true,
  "subject": "urn:mbid:AQAAY7c1",
  "subject_kind": "opaque"
}

Returns Examples

{
  "ok": true,
  "subject": "urn:mbid:AQAAY7c1",
  "subject_kind": "opaque"
}