Skip to main content
POST
Record Birth

Authorizations

Authorization
string
header
required

Get token from Auth0 and paste it here

Path Parameters

organization_id
string
required
employee_id
string
required
absence_id
string
required

Body

application/json

POST .../birth: records the actual birth date; optionally flags stillbirth in the same edition.

actual_birth_date
string<date>
required
stillbirth
boolean | null

When provided, sets the stillbirth flag

Response

Successful Response

One edition, as stored. created_at is the edition's transaction time.

start_date
string<date>
required

First day of leave (inclusive)

end_date
string<date>
required

Last day of leave (inclusive); return to work is the next day

content
GBMaternityAbsence · object
required

GB maternity content payload. ewc anchors the qualifying-week and MPP derivations, so it must be the SUNDAY the expected week of childbirth starts on (HMRC weeks run Sunday to Saturday); rejecting anything else is correct-by-policy rather than silently normalising a caller bug.

absence_id
string
required
employee_id
string
required
created_at
string<date-time>
required
country_code
string
default:GB
Allowed value: "GB"
external_ref
string | null

AMS correlation reference

is_cancelled
boolean
default:false