Contact

Contact us and conversation endpoints

Submit Contact Us Form

post

Submits a contact us message.

Business Logic:

• Email Routing: Sends an email to recipients configured in CONTACT_US_EMAIL_TO based on the operation type.

• User Notification: Optionally sends a copy to the user if CONTACT_US_SEND_USER is enabled.

• Reply-To: Sets the Reply-To header to the user's email if CONTACT_US_REPLY_TO_ONLY_USER is enabled.

• CC/BCC: Applies CC/BCC rules from EMAIL_BCC_AND_CC setting.

• Attachments: Validates and attaches files if provided.

• Order Linking: Links the message to a specific order if required by the subject.

Dynamic Settings:

• CONTACT_US_EMAIL_TO: Dictionary mapping operations to recipient emails.

• CONTACT_US_SEND_USER: Boolean to enable sending a copy to the user.

• CONTACT_US_REPLY_TO_ONLY_USER: Boolean to set user as the only Reply-To address.

• EMAIL_BCC_AND_CC: Configuration for CC and BCC recipients.

Header parameters

X-CSRFTokenstringRequired

CSRF token for write operations (POST, PUT, PATCH, DELETE). Required for security when using session authentication. Obtain token from cookie 'csrftoken' or meta tag in HTML.

Example: abc123def456ghi789

CookiestringRequired

Session ID and CSRF token cookies. Format: sessionid=<id>; osessionid=<id>; csrftoken=<token>

Example: sessionid=abc123def456; osessionid=abc123def456; csrftoken=xyz789

Body

multipart/form-data

subjectintegerRequired

ID of the contact subject. Determines if an order reference is required.

full_namestring · max: 70Required

emailstring · emailRequired

phonestring · max: 70Optional

messagestringRequired

filestring · binaryOptional

Optional file attachment. Validated for allowed extensions and size limits.

orderintegerOptional

ID of the related order. Required if the selected subject implies an order context. Must belong to the authenticated user.

operationstring · max: 30Optional

Operation type key. Validated against configured contact email recipients (CONTACT_US_EMAIL_TO).

Responses

200

Message sent successfully

No content

400

Validation error

application/json

post

/users/contact-us/

HTTPcURLJavaScriptPython

POST /users/contact-us/ HTTP/1.1
Host: sandbox.akinon.com
X-CSRFToken: abc123def456ghi789
Cookie: sessionid=abc123def456; osessionid=abc123def456; csrftoken=xyz789
Content-Type: multipart/form-data
Accept: */*
Content-Length: 134

{
  "subject": 1,
  "full_name": "text",
  "email": "[email protected]",
  "phone": "text",
  "message": "text",
  "file": "binary",
  "order": 1,
  "operation": "text"
}

No content

List Contact Us Subjects

get

Lists available subjects for the contact us form.

Business Logic:

• Returns subjects localized to the current language.

Responses

200

List of subjects

application/json

idintegerOptional

Unique identifier for the contact subject.

textstringOptional

Localized subject text.

is_order_neededbooleanOptional

Indicates if an order ID is required for this subject.

get

/users/contact-us-subjects/

HTTPcURLJavaScriptPython

GET /users/contact-us-subjects/ HTTP/1.1
Host: sandbox.akinon.com
Accept: */*

200

List of subjects

[
  {
    "id": 1,
    "text": "text",
    "is_order_needed": true
  }
]

List Conversations

get

Lists the user's conversations (messages).

Authorizations

cookieAuth

sessionidstringRequired

Responses

200

List of conversations

application/json

idintegerOptional

Unique identifier for the conversation.

subjectstringOptional

The subject of the conversation.

item_objectobjectOptional

Details of the related item (Product or OrderItem). Structure depends on item_content.

item_contentstringOptional

Model name of the item content (e.g., 'product', 'orderitem').

last_message_datestring · date-timeOptional

Timestamp of the last message in the conversation.

is_publicbooleanOptional

Indicates if the conversation is public.

is_answeredbooleanOptional

Indicates if the conversation has been answered.

get

/users/conversations/

HTTPcURLJavaScriptPython

GET /users/conversations/ HTTP/1.1
Host: sandbox.akinon.com
Accept: */*

200

List of conversations

[
  {
    "id": 1,
    "subject": "text",
    "user": {
      "id": 1,
      "first_name": "text",
      "last_name": "text",
      "email": "text",
      "phone": "text",
      "gender": {
        "value": "text",
        "label": "text"
      }
    },
    "datasource": {
      "id": 1,
      "name": "text"
    },
    "item_object": {},
    "item_content": "text",
    "message_set": [
      {
        "id": 1,
        "message_content": "text",
        "user_type": {
          "value": "text",
          "label": "text"
        },
        "content_object": {
          "id": 1,
          "email": "text",
          "first_name": "text",
          "last_name": "text",
          "phone": "text",
          "gender": "text",
          "name": "text",
          "title": "text"
        },
        "content_type": "text",
        "created_date": "2026-03-06T16:32:29.225Z"
      }
    ],
    "conversation_type": {
      "value": "text",
      "label": "text"
    },
    "last_message_date": "2026-03-06T16:32:29.225Z",
    "is_public": true,
    "is_answered": true
  }
]

Create Conversation

post

Creates a new conversation or message.

Authorizations

cookieAuth

sessionidstringRequired

Header parameters

X-CSRFTokenstringRequired

CSRF token for write operations (POST, PUT, PATCH, DELETE). Required for security when using session authentication. Obtain token from cookie 'csrftoken' or meta tag in HTML.

Example: abc123def456ghi789

CookiestringRequired

Session ID and CSRF token cookies. Format: sessionid=<id>; osessionid=<id>; csrftoken=<token>

Example: sessionid=abc123def456; osessionid=abc123def456; csrftoken=xyz789

Body

application/json

Request body for creating a conversation or message.

Validation:

• DataSource cannot reply to a review.
• Users must match the authenticated user and content owner.

message_contentstring · max: 500Required

The body of the message.

user_typestring · enumRequired

Type of user creating the conversation.

Possible values:

content_idinteger · min: 1Required

ID of the related content object (e.g., User ID).

content_typestring · enumRequired

Slug of the content type. Determines the context of the conversation.

Possible values:

conversationintegerOptional

ID of existing conversation to reply to.

datasourceintegerOptional

ID of the datasource (if applicable).

userintegerOptional

ID of the user.

subjectstring · max: 500Optional

Subject of the conversation.

item_contentstring · enumOptional

Model name of the item content. Used to link conversation to specific items.

Possible values:

item_idintegerOptional

ID of the specific item.

conversation_typestring · enumOptional

Type of conversation.

Possible values:

is_publicbooleanOptional

Whether the conversation is public.

Responses

201

Conversation created

400

Validation error

application/json

post

/users/conversations/

HTTPcURLJavaScriptPython

POST /users/conversations/ HTTP/1.1
Host: sandbox.akinon.com
X-CSRFToken: abc123def456ghi789
Cookie: sessionid=abc123def456; osessionid=abc123def456; csrftoken=xyz789
Content-Type: application/json
Accept: */*
Content-Length: 225

{
  "message_content": "text",
  "user_type": "guest",
  "content_id": 1,
  "content_type": "user",
  "conversation": 1,
  "datasource": 1,
  "user": 1,
  "subject": "text",
  "item_content": "product",
  "item_id": 1,
  "conversation_type": "message",
  "is_public": true
}

No content

Retrieve Conversation

get

Retrieves details of a specific conversation.

Authorizations

cookieAuth

sessionidstringRequired

Path parameters

idintegerRequired

Conversation ID

Responses

200

Conversation details

application/json

idintegerOptional

Unique identifier for the conversation.

subjectstringOptional

The subject of the conversation.

item_objectobjectOptional

Details of the related item (Product or OrderItem). Structure depends on item_content.

item_contentstringOptional

Model name of the item content (e.g., 'product', 'orderitem').

last_message_datestring · date-timeOptional

Timestamp of the last message in the conversation.

is_publicbooleanOptional

Indicates if the conversation is public.

is_answeredbooleanOptional

Indicates if the conversation has been answered.

get

/users/conversations/{id}/

HTTPcURLJavaScriptPython

GET /users/conversations/{id}/ HTTP/1.1
Host: sandbox.akinon.com
Accept: */*

200

Conversation details

{
  "id": 1,
  "subject": "text",
  "user": {
    "id": 1,
    "first_name": "text",
    "last_name": "text",
    "email": "text",
    "phone": "text",
    "gender": {
      "value": "text",
      "label": "text"
    }
  },
  "datasource": {
    "id": 1,
    "name": "text"
  },
  "item_object": {},
  "item_content": "text",
  "message_set": [
    {
      "id": 1,
      "message_content": "text",
      "user_type": {
        "value": "text",
        "label": "text"
      },
      "content_object": {
        "id": 1,
        "email": "text",
        "first_name": "text",
        "last_name": "text",
        "phone": "text",
        "gender": "text",
        "name": "text",
        "title": "text"
      },
      "content_type": "text",
      "created_date": "2026-03-06T16:32:29.225Z"
    }
  ],
  "conversation_type": {
    "value": "text",
    "label": "text"
  },
  "last_message_date": "2026-03-06T16:32:29.225Z",
  "is_public": true,
  "is_answered": true
}