# Engage Customer

**POST /engage**

Get-or-create the persistent Experience and invoke engagement_decision.

Returns 202 immediately. On a cache hit the response carries status=COMPLETED
and widget_data; otherwise status=PENDING and the caller polls
GET /experiences/{experience_id}.


## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Http bearer


## Parameters



### Body: application/json (object)

- **external_customer_id** (string)

- **playbook_id** (string)



## Responses
### 202
Successful Response

#### Body: application/json (object)
- **experience_id** (string)

- **access_token** (string)

- **session_id** (string | null)

- **status** (string)

- **widget_data** (object | null)


### 422
Validation Error

#### Body: application/json (object)
- **detail** (array[object])



[Powered by Bump.sh](https://bump.sh)