Skip to main content

Webhooks

We'll send a POST request as soon as the user has:

  • Stored their HSA / FSA payment method
  • Qualified for HSA spending on your store

You can configure your webhook URL in our developer portal.

Request​

interface QualificationWebhookRequest {
  payment_token: "xxxx-xxxx-xxxx-xxxx";
  customer: {
    truemed_id: "1234-5678-90123re",
    email: "[email protected]",
    name: "John Doe",
    metadata: {
      id: "your_id_here",
    },
  };
}

Response​

Just respond with any 2xx-level HTTP response within 1 second.