fix: allow null contact first_name and last_name

[gabrielmfern]

The API returns null for a contact with no name, but both fields were typed NotRequired[str]. That is the wrong axis: NotRequired says the key may be absent, while still promising that if the key is there the value is a real str. null is precisely the case it ruled out, so a type checker would bless contact["first_name"].upper() on a value that is None at runtime.

resend-node's recorded live responses carry "first_name":null in 12 separate fixtures, so this is the normal shape for a contact with no name, not an edge case.

The two types differ on purpose

Contact (retrieve and list) → Optional[str]. The key is always present in real responses, carrying null when there is no name.

ContactEventData (webhook) → NotRequired[Optional[str]]. Here the key really can be missing. The contact.created fixture in resend-dotnet omits first_name and last_name from data entirely, and the OpenAPI schema's required list agrees, covering only id, created_at, updated_at, email, and unsubscribed. So the webhook needs both "may be absent" and "may be null", while the REST types only need the latter.

Optional[str] is already the convention here for nullable response fields, matching ApiKey.last_used_at and the DomainClaim fields.

Request types (CreateParams, UpdateParams) are untouched, since those are inputs.

Verification

mypy is clean on both changed files. The only errors it reports are the pre-existing missing stubs for httpx and requests, which are unrelated.

No test added. These are TypedDicts with no runtime validation, so a test here could only assert that json.loads returns None for null, which restates the language rather than the contract. Happy to add one if you would rather have the documentation value.

Related

Spec fix in resend/resend-openapi#91, which makes the same correction to GetContactResponseSuccess, ListContactsResponseSuccess, and ContactEventData.

Ref DEV-1625

---

Summary by cubic

Allow null contact first_name and last_name in response and webhook types to match API behavior and address DEV-1625. Previously the types allowed missing keys but not nulls; now REST Contact uses Optional[str] and webhook ContactEventData uses NotRequired[Optional[str]].

• Migration: Treat Contact.first_name/last_name as optional and possibly None; in webhooks these keys may be absent and, if present, may be None. No changes to request params or runtime behavior.

^{Written for commit 5bb8baa. Summary will update on new commits.}

Version bump

Includes a patch bump to 2.36.1 in resend/version.py. This repo normally bumps in a separate chore: PR, so drop that commit if you would rather keep the split.

[cubic-dev-ai]

cubic analysis

No issues found across 2 files

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

Linked issue analysis

Linked issue: DEV-1625: Allow nullable contact first and last names in OpenAPI

Status	Acceptance criteria	Notes
✅	Contact first_name and last_name allow null values in retrieve/list response types.	The Contact TypedDict fields changed from NotRequired[str] to Optional[str].
✅	Webhook contact first_name and last_name allow both missing keys and null values.	The webhook fields retain NotRequired while adding Optional[str] for their values.

<sub>Auto-approved: Corrects TypedDict types to match actual API behavior (null names), supported by live fixtures and existing Optional convention. Pure type-contract fix with no runtime or operational impact.

Re-trigger cubic</sub>

Approval not submitted

This repository is configured to approve as @klotty, but that approval identity is unavailable.
Reconnect or verify the approval identity in repository settings.

cubic left this as a normal review comment instead of falling back to a Cubic App approval.

[cubic-dev-ai]

0 issues found across 1 file (changes from recent commits).

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

<sub>Auto-approved: Type-only correction of contact name fields to accurately reflect nullable API responses; no runtime or operational tradeoff, version bump is trivial.

Re-trigger cubic</sub>

Approval not submitted

This repository is configured to approve as @klotty, but that approval identity is unavailable.
Reconnect or verify the approval identity in repository settings.

cubic left this as a normal review comment instead of falling back to a Cubic App approval.