Warning: API Version 1 is deprecated. Please use API Version 2.
Api Documentation

Messages

Messages can be sent from one user to another and can either be a normal message or a connection invite. For privacy reasons, user authentication is always required for this endpoint.
listchevron_right
Retrieves all messages for the current user.
singlechevron_right
Retrieves a single message.
createchevron_right
Sends a new message or connection invite.
updatechevron_right
Updates the status of a message or connection invite. Can only be changed by the recipient. Accepting an invitation will create a connection between the author and the recipient of the message.
deletechevron_right
Deletes a single message or invitation.
Json
XML
POST https://api.bundeling.com/V1/messages

Parameters

Body

NameDescriptionTypeNillableRequired
recipient_idThe id of the recieving user.intfalsetrue
typeDefines if it is a message, or a user connection invitation.
Accepted values: message, invite
stringfalsetrue
colleague_user_idWhen 2 users are already connected, they can introduce colleagues to eachother by sending an "invite" with the id of the user to introduce in this field.intfalsefalse
in_response_to_idWhen a user replies to a message, the original message id can be set in this field. This will create a chained message.intfalsefalse
messageThe actual body of the message.stringfalsetrue

Example request

Headers

Content-Type:application/json
Api-Key:RAegSX8yZfEbqSPM

Body

{
    "recipient_id": 9,
    "type": "message",
    "colleague_user_id": 12,
    "in_response_to_id": 7,
    "message": "Dear John Doe..."
}

Example response

{
    "id": 102,
    "author_id": 6,
    "recipient_id": 9,
    "type": "message",
    "colleague_user_id": 0,
    "in_response_to_id": 7,
    "status": "unread",
    "message": "Dear John Doe...",
    "creationdate": "2017-02-10T16:35:00+0000"
}