# Sync contact birthday & optionally greet immediately
URL: /docs/api-reference/birthdays-milestones/syncContactBirthday

## POST `/api/v1/public/birthdays/sync`

**Summary:** Sync contact birthday & optionally greet immediately
**Operation ID:** `syncContactBirthday`

Saves contact date of birth for automated celebration alerts and optionally dispatches an immediate greeting SMS.

**Authentication:** `X-Api-Key: sk_live_...` or `Authorization: Bearer sk_live_...`

### Request Body (`application/json`)

```json
{
  "type": "object",
  "required": [
    "phoneNumber"
  ],
  "properties": {
    "phoneNumber": {
      "type": "string",
      "example": "+233241234567"
    },
    "name": {
      "type": "string",
      "example": "Kwame Mensah"
    },
    "birthDate": {
      "type": "string",
      "format": "date",
      "example": "1994-06-15"
    },
    "sendGreetImmediately": {
      "type": "boolean",
      "default": false
    }
  }
}
```

### Responses

- **`200`**: Contact birthday synced or greeting dispatched

```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "example": "success"
    },
    "message": {
      "type": "string",
      "example": "Contact birthday synced"
    }
  }
}
```
- **`401`**: Authentication failed or API key missing