> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getstrada.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Push call personalization data

> Push customer data for a phone number ahead of an inbound call. When a call arrives from this number, the data will be used to populate the agent's prompt variables.

Only the most recent push for a phone number is used. Once a call consumes the data, it is marked as consumed and will not be used for subsequent calls. If the most recent push has already been consumed, the agent proceeds without personalization. Older pushes are never used as a fallback. Push new data to hydrate the next call.

Phone numbers are automatically normalized to E.164 format.



## OpenAPI

````yaml post /api/call-personalization-webhook
openapi: 3.1.0
info:
  title: Strada Voice API
  version: 1.0.0
  description: API for managing voice calls
servers:
  - url: https://api.getstrada.com
    description: Production server
security: []
paths:
  /api/call-personalization-webhook:
    post:
      tags:
        - Incoming Call Personalization
      summary: Push call personalization data
      description: >-
        Push customer data for a phone number ahead of an inbound call. When a
        call arrives from this number, the data will be used to populate the
        agent's prompt variables.


        Only the most recent push for a phone number is used. Once a call
        consumes the data, it is marked as consumed and will not be used for
        subsequent calls. If the most recent push has already been consumed, the
        agent proceeds without personalization. Older pushes are never used as a
        fallback. Push new data to hydrate the next call.


        Phone numbers are automatically normalized to E.164 format.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PushCallPersonalizationRequest'
            example:
              phoneNumber: '+15551234567'
              data:
                firstName: John
                policyNumber: POL-12345
                claimStatus: Active
      responses:
        '200':
          description: Data pushed successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PushCallPersonalizationResponse'
              example:
                success: true
        '400':
          description: Bad request - invalid or missing fields
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: 'phoneNumber: phoneNumber is required'
        '401':
          description: Unauthorized - invalid or missing API key
        '429':
          description: Too many requests - rate limit exceeded
      security:
        - bearerAuth: []
components:
  schemas:
    PushCallPersonalizationRequest:
      type: object
      required:
        - phoneNumber
        - data
      properties:
        phoneNumber:
          type: string
          description: >-
            Customer phone number. Automatically normalized to E.164 format. US
            numbers are assumed for 10-digit inputs.
          example: '+15551234567'
        data:
          type: object
          additionalProperties: true
          description: >-
            Key-value pairs of personalization data. Keys must match the
            variable names defined in your agent's prompt (e.g., firstName,
            policyNumber).
          example:
            firstName: John
            policyNumber: POL-12345
            claimStatus: Active
    PushCallPersonalizationResponse:
      type: object
      properties:
        success:
          type: boolean
          description: Whether the data was stored successfully
          example: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: API Key authentication

````