Audience: Application developers
Editorial status: Published — Source Validated
Product: FeraEmail
Classification: partner
Webhook event: product.lifecycle.acknowledgment
FeraEmail directly posts one exact-body HMAC callback after lifecycle success or failure. There is no internal retry loop; a failed success callback fails the source request so FeraHooks can redeliver the idempotent event.
Parameters
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
x-feradel-service |
header | string | Yes | Sending service identifier, always feradel.email.api. |
x-feradel-hook-timestamp |
header | string | Yes | Unix timestamp in seconds covered by the signature. |
x-feradel-hook-signature |
header | string | Yes | Versioned SHA-256 HMAC over timestamp, a period, and the exact raw body. |
Request body
Typed lifecycle completion or failure acknowledgment.
application/json
Schema: LifecycleAcknowledgment
{
"eventId": "715c9ebb-0470-11f1-a928-0ed2cd1b87df",
"eventType": "product.provisioning.completed",
"eventVersion": 1,
"correlationId": "715c9ebb-0470-11f1-a928-0ed2cd1b87df",
"licenseProductId": "715c9ebb-0470-11f1-a928-0ed2cd1b87df",
"productInstanceId": "715c9ebb-0470-11f1-a928-0ed2cd1b87df",
"result": {
"userProvisioned": true,
"ownerRoleAssigned": true,
"settingsApplied": true
}
}Responses
200 FeraLicense accepted the lifecycle acknowledgment.
Source
feradelinc/feradel.email.api branch agent/catch-up-email-api, commit b4278c2d3ef83b95a6cd26c1fd6ec45a0adb99b5
openapi.webhooks.product.lifecycle.acknowledgment