Thanks for signing up.
\",\n});\n\nexport const templateId = template.id;\n```\n\n### Webhook\n\nSet up webhooks for email events:\n\n```typescript\nconst webhook = new resend.Webhook(\"events\", {\n endpoint: \"https://api.example.com/webhooks/resend\",\n events: [\"email.sent\", \"email.delivered\", \"email.bounced\"],\n});\n\nexport const webhookId = webhook.id;\n```\n\n### Send Email (Function)\n\nSend emails directly via Pulumi:\n\n```typescript\nconst result = resend.sendEmail({\n from: \"hello@mail.example.com\",\n to: [\"user@example.com\"],\n subject: \"Hello from Pulumi!\",\n html: \"This email was sent via infrastructure as code.
\",\n});\n\nexport const emailId = result.then(r => r.emailId);\n```\n\n> **Note**: `sendEmail` is a function (invoke), not a resource. It executes on every `pulumi up` and doesn't maintain state.\n\n### Topic\n\nManage subscription topics that control contact email preferences:\n\n```typescript\nimport * as resend from \"@humanlayer/pulumi-resend\";\n\nconst newsletter = new resend.Topic(\"newsletter\", {\n name: \"Newsletter\",\n defaultSubscription: \"opt_in\",\n description: \"Weekly product updates\",\n visibility: \"public\",\n});\n\nexport const topicId = newsletter.id;\n```\n\n**Notes:**\n- `defaultSubscription` is immutable after creation; changes require replacement\n- `name`, `description`, and `visibility` can be updated in place\n\n### Event\n\nDefine custom event types that trigger automations:\n\n```typescript\nimport * as resend from \"@humanlayer/pulumi-resend\";\n\nconst userCreated = new resend.Event(\"userCreated\", {\n name: \"user.created\",\n schema: {\n user_id: \"string\",\n plan: \"string\",\n trial_days: \"number\",\n },\n});\n\nexport const eventId = userCreated.id;\n```\n\n**Notes:**\n- Event `name` is immutable; changes require replacement\n- `schema` can be updated in place\n- Names must not start with `resend:` (reserved prefix)\n\n### ContactProperty\n\nDefine custom fields on contacts:\n\n```typescript\nimport * as resend from \"@humanlayer/pulumi-resend\";\n\nconst companyName = new resend.ContactProperty(\"companyName\", {\n key: \"company_name\",\n type: \"string\",\n fallbackValue: \"Unknown\",\n});\n\nexport const propertyId = companyName.id;\n```\n\n**Notes:**\n- `key` and `type` are immutable; changes require replacement\n- Only `fallbackValue` can be updated in place\n- Key must be alphanumeric with underscores, max 50 characters\n\n### Segment\n\nCreate contact segments for targeted broadcasts:\n\n```typescript\nimport * as resend from \"@humanlayer/pulumi-resend\";\n\nconst activeUsers = new resend.Segment(\"activeUsers\", {\n name: \"Active Users\",\n});\n\nexport const segmentId = activeUsers.id;\n```\n\n**Notes:**\n- Segments are immutable after creation (no update API)\n- Any change to inputs requires delete and recreate\n\n### Automation\n\nCreate multi-step email automation workflows:\n\n```typescript\nimport * as resend from \"@humanlayer/pulumi-resend\";\n\nconst template = new resend.Template(\"welcome\", {\n name: \"Welcome Email\",\n html: \"Thanks for signing up.
\",\n});\n\nconst automation = new resend.Automation(\"welcomeSequence\", {\n name: \"Welcome Sequence\",\n status: \"disabled\",\n steps: [\n {\n key: \"trigger\",\n type: \"trigger\",\n config: { event_name: \"user.created\" },\n },\n {\n key: \"send_welcome\",\n type: \"send_email\",\n config: {\n template: { id: template.id },\n subject: \"Welcome aboard!\",\n },\n },\n {\n key: \"wait_3_days\",\n type: \"delay\",\n config: { duration: \"3 days\" },\n },\n ],\n connections: [\n { from: \"trigger\", to: \"send_welcome\" },\n { from: \"send_welcome\", to: \"wait_3_days\" },\n ],\n});\n\nexport const automationId = automation.id;\n```\n\n**Step types:** `trigger`, `send_email`, `delay`, `wait_for_event`, `condition`, `contact_update`, `contact_delete`, `add_to_segment`\n\n**Connection types:** `default`, `condition_met`, `condition_not_met`, `timeout`, `event_received`\n\n### Send Batch Email (Function)\n\nSend up to 100 emails in a single API call:\n\n```typescript\nimport * as resend from \"@humanlayer/pulumi-resend\";\n\nconst result = await resend.sendBatchEmail({\n emails: [\n {\n from: \"hello@mail.example.com\",\n to: [\"user1@example.com\"],\n subject: \"Hello User 1\",\n html: \"Hello!
\",\n },\n {\n from: \"hello@mail.example.com\",\n to: [\"user2@example.com\"],\n subject: \"Hello User 2\",\n html: \"Hello!
\",\n },\n ],\n});\n```\n\n### Send Event (Function)\n\nTrigger custom events for automations:\n\n```typescript\nimport * as resend from \"@humanlayer/pulumi-resend\";\n\nconst result = await resend.sendEvent({\n event: \"user.created\",\n email: \"newuser@example.com\",\n payload: {\n plan: \"pro\",\n trial_days: 14,\n },\n});\n```\n\n**Notes:**\n- Exactly one of `contactId` or `email` must be provided\n\n### Send Broadcast (Function)\n\nCreate and send a one-time email campaign to a segment:\n\n```typescript\nimport * as resend from \"@humanlayer/pulumi-resend\";\n\nconst customers = new resend.Segment(\"customers\", {\n name: \"All Customers\",\n});\n\nconst result = await resend.sendBroadcast({\n from: \"updates@mail.example.com\",\n subject: \"Important Announcement\",\n segmentId: customers.id,\n html: \"Hello!
\",\n previewText: \"We have exciting news...\",\n});\n```\n\n**Notes:**\n- Creates and sends the broadcast atomically\n- Supports scheduled sending via `scheduledAt` (ISO 8601 timestamp)\n\n## Examples\n\n### Complete Email Platform Setup\n\nSet up a full email platform with domain verification, templates, topics, and automation:\n\n```typescript\nimport * as resend from \"@humanlayer/pulumi-resend\";\n\n// 1. Domain with tracking enabled\nconst domain = new resend.Domain(\"mail\", {\n name: \"mail.example.com\",\n region: \"us-east-1\",\n openTracking: true,\n clickTracking: true,\n});\n\n// 2. Verify the domain (polls until DNS records are confirmed)\nconst verification = new resend.DomainVerification(\"verify\", {\n domainId: domain.id,\n});\n\n// 3. Scoped API key for sending only\nconst sendingKey = new resend.ApiKey(\"sender\", {\n name: \"production-sender\",\n permission: \"sending_access\",\n domainId: domain.id,\n});\n\n// 4. Subscription topics\nconst newsletter = new resend.Topic(\"newsletter\", {\n name: \"Newsletter\",\n defaultSubscription: \"opt_in\",\n description: \"Weekly product updates and tips\",\n visibility: \"public\",\n});\n\nconst marketing = new resend.Topic(\"marketing\", {\n name: \"Marketing\",\n defaultSubscription: \"opt_out\",\n description: \"Promotional offers and announcements\",\n visibility: \"public\",\n});\n\n// 5. Contact properties for personalization\nconst companyName = new resend.ContactProperty(\"company\", {\n key: \"company_name\",\n type: \"string\",\n fallbackValue: \"there\",\n});\n\nconst plan = new resend.ContactProperty(\"plan\", {\n key: \"plan\",\n type: \"string\",\n fallbackValue: \"free\",\n});\n\n// 6. Webhook for delivery tracking\nconst webhook = new resend.Webhook(\"delivery-events\", {\n endpoint: \"https://api.example.com/webhooks/resend\",\n events: [\n \"email.sent\",\n \"email.delivered\",\n \"email.bounced\",\n \"email.complained\",\n \"email.opened\",\n \"email.clicked\",\n ],\n});\n\nexport const domainId = domain.id;\nexport const dnsRecords = domain.records;\nexport const apiKeyToken = sendingKey.token;\n```\n\n### Welcome Email Automation\n\nBuild a multi-step onboarding sequence triggered when users sign up:\n\n```typescript\nimport * as resend from \"@humanlayer/pulumi-resend\";\n\n// Define the trigger event\nconst signupEvent = new resend.Event(\"signup\", {\n name: \"user.signup\",\n schema: {\n first_name: \"string\",\n plan: \"string\",\n trial_days: \"number\",\n },\n});\n\n// Create email templates\nconst welcomeTemplate = new resend.Template(\"welcome\", {\n name: \"Welcome Email\",\n subject: \"Welcome to Example, {{first_name}}!\",\n from: \"hello@mail.example.com\",\n html: `\nThanks for joining us on the {{plan}} plan.
\nYou have {{trial_days}} days to explore everything.
\n `,\n});\n\nconst tipsTemplate = new resend.Template(\"tips\", {\n name: \"Getting Started Tips\",\n subject: \"3 tips to get the most out of Example\",\n from: \"hello@mail.example.com\",\n html: \"Here's how to get started...
\",\n});\n\nconst checkInTemplate = new resend.Template(\"checkin\", {\n name: \"Check-in Email\",\n subject: \"How's it going, {{first_name}}?\",\n from: \"hello@mail.example.com\",\n html: \"Just checking in...
\",\n});\n\n// Build the automation workflow\nconst onboarding = new resend.Automation(\"onboarding\", {\n name: \"New User Onboarding\",\n status: \"enabled\",\n steps: [\n {\n key: \"trigger\",\n type: \"trigger\",\n config: { event_name: \"user.signup\" },\n },\n {\n key: \"welcome\",\n type: \"send_email\",\n config: {\n template: { id: welcomeTemplate.id },\n },\n },\n {\n key: \"wait_2_days\",\n type: \"delay\",\n config: { duration: \"2 days\" },\n },\n {\n key: \"tips\",\n type: \"send_email\",\n config: {\n template: { id: tipsTemplate.id },\n },\n },\n {\n key: \"wait_5_days\",\n type: \"delay\",\n config: { duration: \"5 days\" },\n },\n {\n key: \"checkin\",\n type: \"send_email\",\n config: {\n template: { id: checkInTemplate.id },\n },\n },\n ],\n connections: [\n { from: \"trigger\", to: \"welcome\" },\n { from: \"welcome\", to: \"wait_2_days\" },\n { from: \"wait_2_days\", to: \"tips\" },\n { from: \"tips\", to: \"wait_5_days\" },\n { from: \"wait_5_days\", to: \"checkin\" },\n ],\n});\n\n// Trigger the automation for a new user (invoke)\nconst triggerSignup = resend.sendEvent({\n event: \"user.signup\",\n email: \"newuser@example.com\",\n payload: {\n first_name: \"Alice\",\n plan: \"pro\",\n trial_days: 14,\n },\n});\n```\n\n### Domain Setup with AWS Route53\n\nUse domain DNS records to configure Route53 automatically:\n\n```typescript\nimport * as resend from \"@humanlayer/pulumi-resend\";\nimport * as aws from \"@pulumi/aws\";\n\nconst domain = new resend.Domain(\"mail\", {\n name: \"mail.example.com\",\n region: \"us-east-1\",\n});\n\nconst zone = aws.route53.getZone({ name: \"example.com\" });\n\n// Create DNS records from the domain's output\ndomain.records.apply(records => {\n records.forEach((rec, i) => {\n new aws.route53.Record(`dns-${i}`, {\n zoneId: zone.then(z => z.zoneId),\n name: rec.name,\n type: rec.type,\n records: [rec.value],\n ttl: parseInt(rec.ttl) || 300,\n });\n });\n});\n\n// Verify after DNS records are created\nconst verification = new resend.DomainVerification(\"verify\", {\n domainId: domain.id,\n});\n```\n\n### Conditional Automation with Branching\n\nCreate an automation with conditional logic based on user properties:\n\n```typescript\nimport * as resend from \"@humanlayer/pulumi-resend\";\n\nconst automation = new resend.Automation(\"trial-followup\", {\n name: \"Trial Expiry Follow-up\",\n status: \"enabled\",\n steps: [\n {\n key: \"trigger\",\n type: \"trigger\",\n config: { event_name: \"trial.expiring\" },\n },\n {\n key: \"check_plan\",\n type: \"condition\",\n config: {\n type: \"rule\",\n field: \"plan\",\n operator: \"equals\",\n value: \"enterprise\",\n },\n },\n {\n key: \"enterprise_email\",\n type: \"send_email\",\n config: {\n template: { id: \"tmpl_enterprise_upsell\" },\n subject: \"Your enterprise trial is ending soon\",\n },\n },\n {\n key: \"standard_email\",\n type: \"send_email\",\n config: {\n template: { id: \"tmpl_standard_upsell\" },\n subject: \"Upgrade before your trial ends\",\n },\n },\n ],\n connections: [\n { from: \"trigger\", to: \"check_plan\" },\n { from: \"check_plan\", to: \"enterprise_email\", type: \"condition_met\" },\n { from: \"check_plan\", to: \"standard_email\", type: \"condition_not_met\" },\n ],\n});\n```\n\n### Importing Existing Resources\n\nImport existing Resend resources into Pulumi state:\n\n```bash\n# Import an existing domain\npulumi import resend:index:Domain myDomain d_abc123\n\n# Import an existing API key\npulumi import resend:index:ApiKey myKey ak_xyz789\n\n# Import an existing webhook\npulumi import resend:index:Webhook myWebhook wh_def456\n\n# Import an existing template\npulumi import resend:index:Template myTemplate tmpl_ghi789\n```\n\n### YAML Example\n\n```yaml\nname: resend-email-infra\nruntime: yaml\n\nresources:\n domain:\n type: resend:index:Domain\n properties:\n name: mail.example.com\n region: us-east-1\n openTracking: true\n\n apiKey:\n type: resend:index:ApiKey\n properties:\n name: my-sending-key\n permission: sending_access\n\n newsletter:\n type: resend:index:Topic\n properties:\n name: Newsletter\n defaultSubscription: opt_in\n visibility: public\n\n welcomeTemplate:\n type: resend:index:Template\n properties:\n name: Welcome\n subject: Welcome!\n html: \"