Inviting a person to become a colleague
Added by IBM contributorIBM | Edited by Claudia R Elbourn on June 15, 2015
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

To invite a person to become a colleague, send an Atom entry document containing the connection resource to the person's colleague connections feed.
To find a person's colleague connections feed, a user can search for the person by name. From the returned feed, a user can find the person, retrieve the associated user ID, and then use the user ID to retrieve the person's full feed, which includes a link to her colleague connections feed.

After the user sends the invitation, the connection is added to the user's connections in an unconfirmed state. The connection is added to the connections of the person the user invited in a pending state. See Accepting an invitation to become a colleague f information about how to accept an invitation.


1. Retrieve any user's Profiles service document using the user's credentials to authenticate the request. See Retrieving the Profiles service document
2. In the service document, find the href attribute value where the value of the rel attribute is
For example:
3. With the link specified by step 2, perform a POST using the sample request entry. This will send an invite to that person requesting them to be your connections colleague.

Method URI Description
POST /profiles/atom/ Value of the href attribute of the <link> element with the rel="" attribute value. Note: You must include the connectionType=colleague parameter with this request.
Content Type: application/atom+xml
Sample Request:

<entry xmlns="">
   <content type="text">Please be my new colleague connection!</content>
   <category scheme="" term="connection" />
   <category scheme="" term="colleague" />
   <category scheme="" term="pending" />
Name Type Optional Description
string Yes The internet email address of the person whose Profile you wish to receive.
You must use either email or key to send a connections colleague invite.
string No An ID generated by Profiles to identify a person.
You must use either email or key to send a connections colleague invite.
string No Identifies the type of connection to look for. You must specify connectionType=colleague.
Name Type Optional Description
string No Link to edit_url of the connection entry. You can use the web address specified here to subsequently retrieve and update the connection.
Code Description
Indicates that the invitation to connect was successfully created.
Bad Request. Returned when no matching user record can be found.
Unauthorized. Returned when no authenticated user or no userid, email, or key parameter are provided on the request.
Here is a sample request entry and response for a colleague invitation. Note that in deployments where email is exposed, the invitee may be referenced by the email parameter, otherwise the key parameter should be used
<entry xmlns="" xmlns:snx="">
  <category scheme="" term="connection"/>
  <category scheme="" term="colleague"/>
  <category scheme="" term="pending"/>
  <!-- Message to other user -->
  <content type="html">

   Please accept this invitation to be in my network of Connections colleagues.


Response returned by the server
HTTP/1.1 201 Created