Workflow · version 1.0

Verify webhook newsletter signups before SendGrid welcome email

Validate incoming newsletter signup webhooks with ValidReach before adding the subscriber to SendGrid Marketing Campaigns or sending a confirmation email.

Starts when: HTTPS POST from your website signup form backend.

Steps

  1. 1. Receive signup webhook (trigger)

    Read the submitted email address and consent metadata.

  2. 2. Verify address with ValidReach (http)

    POST the address to /api/v1/verify/single.

  3. 3. Check verification verdict (branch)

    Branch on data.status.

  4. 4. Upsert SendGrid contact and send welcome (action)

    Add the verified subscriber to SendGrid and trigger the double opt-in or welcome email.

  5. 5. Return validation error to form (action)

    Reject invalid or disposable addresses before calling SendGrid.

Connections

  • Receive signup webhook → Verify address with ValidReach
  • Verify address with ValidReach → Check verification verdict
  • Check verification verdict → Upsert SendGrid contact and send welcome (valid, catchall, unknown)
  • Check verification verdict → Return validation error to form (invalid, disposable)

Credentials you provide

  • ValidReach API key YOUR_API_KEY: Create it under Settings → API keys and store it in your automation tool’s secret storage.
  • SendGrid API key YOUR_SENDGRID_API_KEY: Use a scoped SendGrid key restricted to Marketing and Mail Send.

Sample

POST https://validreach.dev/api/v1/verify/single
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{"email":"user@example.com"}
{
  "success": true,
  "data": {
    "email": "user@example.com",
    "status": "valid",
    "is_deliverable": true,
    "reason": "accepted_email",
    "credits_used": 1,
    "retryable": false
  }
}

Before you run it

Allow unknown results to proceed to double opt-in confirmation so temporary DNS/SMTP timeouts do not block real subscribers.

Verification status. Schema: checked in unit tests. Import: not tested on any platform. Sandbox run: not run. The download is this ValidReach definition, not an importable file for an automation platform.