# Create User

When an end-user starts a conversation in the Fin Messenger and there is no information about them in the third party we request a new record be created.

Endpoint: POST /user
Version: 0.0.1
Security: BearerAuth

## Request fields (application/json):

  - `name` (string,null)
    User's name (may not be known at creation time)
    Example: "Jane Doe"

  - `email` (string,null)
    User's email (may not be known at creation time)
    Example: "jane.doe@example.com"

  - `object_id` (string)
    Unique identifier for the user in our system
    Example: "123456"

## Response 201 fields (application/json):

  - `id` (string, required)
    Unique identifier for the user in your system
    Example: "user_123456"

  - `user_type` (string, required)
    Type of user
    Enum: "end_user"

  - `name` (string,null)
    User's display name
    Example: "Jane Doe"

  - `email` (string,null)
    User's email address
    Example: "jane.doe@example.com"

  - `photo_url` (string,null)
    URL to user's avatar/profile picture (displayed in Fin Messenger)
    Example: "https://example.com/avatars/jane.jpg"

  - `attributes` (object,null)
    Attributes associated with the end-user
    Example: {"plan_type":"enterprise","signup_date":"2024-01-15","is_premium":true}