Skip to main content
POST
/
:projectId
/
users
/
:userId
/
connection
Request Connection
curl --request POST \
  --url https://api.replyke.com/api/v6/:projectId/users/:userId/connection
Send a connection request to another user. Connections are bidirectional relationships that require mutual agreement between two users.

​
Request

​
Path Parameters

ParameterTypeRequiredDescription
userIdstringYesID of the user to send connection request to

​
Headers

HeaderTypeRequiredDescription
AuthorizationstringYesBearer token for authentication.

​
Body Parameters

ParameterTypeRequiredDescription
messagestringNoOptional message with connection request

​
Example Request

POST /users/user-uuid-123/connection
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json

{
  "message": "Hi! I'd like to connect with you."
}

​
Response

​
Success Response (201 Created)

{
  "id": "connection-uuid",
  "status": "pending",
  "createdAt": "2024-01-01T12:00:00.000Z"
}

​
Error Responses

​
Invalid User ID (400 Bad Request)

{
  "error": "Invalid or missing userId",
  "code": "connection/invalid-receiver-id"
}

​
Self-Request Attempt (400 Bad Request)

{
  "error": "Cannot send request to self",
  "code": "connection/self-request"
}

​
User Not Found (404 Not Found)

{
  "error": "User doesn't exist",
  "code": "connection/user-not-found"
}

​
Connection Already Exists (409 Conflict)

Request already pending: 
{
  "error": "Request already pending",
  "code": "connection/request-pending"
}
Already connected: 
{
  "error": "Users already connected",
  "code": "connection/already-connected"
}
Previous request declined: 
{
  "error": "Previous request declined, only receiver can re-initiate",
  "code": "connection/request-declined"
}

​
Server Error (500 Internal Server Error)

{
  "error": "Internal server error",
  "code": "connection/server-error"
}

​
Notes

  • Creates a connection request with “pending” status
  • Receiver will be notified of the connection request
  • Cannot send requests to yourself
  • Only one active connection record between any two users
  • If previous request was declined, only the original receiver can create a new request
  • Rate limiting: 25 requests per 5 minutes