> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thanx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pre Cert Checklist Subscriber Ingestion

# Pre-Certification Self-Check: Subscriber Ingestion Integration

Complete ALL items before contacting [developer.support@thanx.com](mailto:developer.support@thanx.com) for certification.

***

## API Headers & General

* [ ] All requests include `Authorization` header (Bearer token)
* [ ] All requests include `X-ClientId` header
* [ ] All requests include `Accept-Version: v4.0` header
* [ ] All requests include `Content-Type: application/json` header
* [ ] All requests include `User-Agent` header
* [ ] No unnecessary duplicate API requests
* [ ] Error messages handled gracefully
* [ ] Requests issued at a reasonable frequency (not rapidly submitting the same email)

## Setup & Discovery

* [ ] Get Merchants endpoint called to retrieve merchant ID
* [ ] Merchant ID stored and reused for subsequent requests (single-merchant integrations)
* [ ] Get Scopes endpoint called to verify `subscribers.write` scope is available (optional but recommended)

## Subscriber Creation

* [ ] Create Subscriber endpoint called with required fields:
  * [ ] `merchant_id` — correct merchant ID
  * [ ] `email` — valid email address
* [ ] All fields wrapped inside `subscriber` key in request body
* [ ] Optional fields populated when available:
  * [ ] `first_name`
  * [ ] `last_name`
  * [ ] `birth_date` as nested object: `{ "month": 8, "day": 14 }` (a deprecated `year` field is also accepted but not required)
  * [ ] `zip_code`
* [ ] 201 Created response handled correctly (returned for any valid email, including existing users)
* [ ] 400 Bad Request response handled (invalid email address)

## Consent

* [ ] All subscriber data submitted has explicit user consent for the merchant's marketing
* [ ] Email addresses obtained without proper opt-in are NOT submitted

## Submission Format

* [ ] Integration tested against Thanx Sandbox environment
* [ ] All sandbox API calls visible in DataDog logs
* [ ] Ready to demonstrate: subscriber creation, optional field handling, bulk workflow (if applicable), sync mechanism (if applicable)

***

**After completing all items above, email [developer.support@thanx.com](mailto:developer.support@thanx.com) to schedule your certification review.**