Sync webhook types with the current API

[mklocek]

Changes

Brings the SDK's webhook management types in line with the current Webhooks API (per the OpenAPI spec).

• WebhookType — add the two missing members: campaigns and inbound_receiving (previously only email_sending and audit_log).
• Add inbound_inbox_id to Webhook (number | null), CreateWebhookParams, and UpdateWebhookParams (number), used by inbound_receiving webhooks.
• Update the update() doc comment, which no longer omitted inbound_inbox_id from the mutable fields.
• Add a create() test covering an inbound_receiving webhook linked to an inbox.

SendingStream and WebhookEventType already matched the API and were left unchanged.

[coderabbitai]

📝 Walkthrough

Walkthrough

Webhook types now support campaigns and inbound_receiving, with optional inbox associations in webhook models and parameters. Tests cover creating an inbound receiving webhook, and update documentation marks the inbox association immutable.

Changes

Webhook contract and creation support

Layer / File(s)	Summary
Webhook type and payload contracts src/types/api/webhooks.ts	WebhookType adds campaigns and inbound_receiving; webhook models and parameters add optional inbound_inbox_id fields.
Inbound webhook creation coverage src/__tests__/lib/api/resources/Webhooks.test.ts, src/lib/api/resources/Webhooks.ts	Tests validate inbound webhook creation requests and responses, while update documentation identifies inbound_inbox_id as immutable.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

• mailtrap/mailtrap-nodejs#126: Adds the Webhooks API endpoint implementations extended by these type and creation changes.

Suggested reviewers: igordobryn

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Title check	✅ Passed	The title clearly reflects the main change: aligning webhook types with the current API.
Description check	✅ Passed	The description covers the main changes well, but it omits the template's Motivation, How to test, and Images/GIFs sections.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}