Skip to main content

Contact Messages

Manage contact form submissions from users.

Create Contact Message

POST
endpoint
/api/contact_messages
Creates a new contact message from the contact form. Request Body
name
string
required
Name of the person submitting the message
email
string
required
Email address for replies
subject
string
required
Subject of the message
message
string
required
Message content
sourcePage
string
Page URL where the contact form was submitted
status
enum
Message status. Values: NEW, READ, ARCHIVED. Default: NEW
createdAt
string
Timestamp when message was created (ISO 8601 format)
Response
contactMessageId
integer
Unique identifier for the contact message
name
string
Sender’s name
email
string
Sender’s email
subject
string
Message subject
message
string
Message content
sourcePage
string
Source page URL
status
enum
Message status: NEW, READ, or ARCHIVED
createdAt
string
Creation timestamp
Example Request
curl -X POST http://localhost:8080/api/contact_messages \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Carlos Hernández",
    "email": "carlos@example.com",
    "subject": "Partnership inquiry",
    "message": "I am interested in partnering with Kin Conecta to offer tours in Guadalajara. Could you provide more information about your guide program?",
    "sourcePage": "https://kinconecta.com/contact",
    "status": "NEW"
  }'
Example Response
{
  "contactMessageId": 2341,
  "name": "Carlos Hernández",
  "email": "carlos@example.com",
  "subject": "Partnership inquiry",
  "message": "I am interested in partnering with Kin Conecta to offer tours in Guadalajara. Could you provide more information about your guide program?",
  "sourcePage": "https://kinconecta.com/contact",
  "status": "NEW",
  "createdAt": "2026-03-11T14:22:35"
}

Get All Contact Messages

GET
endpoint
/api/contact_messages
Retrieves all contact messages. Example Request
curl http://localhost:8080/api/contact_messages
Example Response
[
  {
    "contactMessageId": 2341,
    "name": "Carlos Hernández",
    "email": "carlos@example.com",
    "subject": "Partnership inquiry",
    "message": "I am interested in partnering with Kin Conecta.",
    "sourcePage": "https://kinconecta.com/contact",
    "status": "NEW",
    "createdAt": "2026-03-11T14:22:35"
  },
  {
    "contactMessageId": 2340,
    "name": "Ana Martínez",
    "email": "ana@example.com",
    "subject": "General question",
    "message": "What areas do your guides cover?",
    "sourcePage": "https://kinconecta.com/faq",
    "status": "READ",
    "createdAt": "2026-03-11T09:15:22"
  }
]

Get Contact Message by ID

GET
endpoint
/api/contact_messages/{id}
Retrieves a specific contact message by ID. Path Parameters
id
integer
required
The contact message ID
Example Request
curl http://localhost:8080/api/contact_messages/2341
Example Response
{
  "contactMessageId": 2341,
  "name": "Carlos Hernández",
  "email": "carlos@example.com",
  "subject": "Partnership inquiry",
  "message": "I am interested in partnering with Kin Conecta to offer tours in Guadalajara. Could you provide more information about your guide program?",
  "sourcePage": "https://kinconecta.com/contact",
  "status": "NEW",
  "createdAt": "2026-03-11T14:22:35"
}

Update Contact Message

PUT
endpoint
/api/contact_messages/{id}
Updates a contact message (typically to change its status). Path Parameters
id
integer
required
The contact message ID
Request Body Same fields as Create Contact Message. Example Request
curl -X PUT http://localhost:8080/api/contact_messages/2341 \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Carlos Hernández",
    "email": "carlos@example.com",
    "subject": "Partnership inquiry",
    "message": "I am interested in partnering with Kin Conecta to offer tours in Guadalajara.",
    "sourcePage": "https://kinconecta.com/contact",
    "status": "READ"
  }'
Example Response
{
  "contactMessageId": 2341,
  "name": "Carlos Hernández",
  "email": "carlos@example.com",
  "subject": "Partnership inquiry",
  "message": "I am interested in partnering with Kin Conecta to offer tours in Guadalajara.",
  "sourcePage": "https://kinconecta.com/contact",
  "status": "READ",
  "createdAt": "2026-03-11T14:22:35"
}

Delete Contact Message

DELETE
endpoint
/api/contact_messages/{id}
Deletes a contact message. Path Parameters
id
integer
required
The contact message ID
Example Request
curl -X DELETE http://localhost:8080/api/contact_messages/2341

Build docs developers (and LLMs) love