/types endpoints allow you to share content out to multiple services at
once. We currently support sharing
photos to multiple
services at once. We also support Facebook Open Graph actions.
The URL pattern for sharing looks like
:typeThe type of data you wish to share.
toA comma-delimited list of supported services you wish to share to. Eg,
servicesDEPRECATED A synonym for
The response is a JSON object with an entry for each service you shared to.
Users who administer Facebook Pages can share on behalf of the page. Do this by
specifying a full
ID@facebook in the
In order to share stories as Facebook Pages, your application must explicitly
manage_pages permission during
authorization. Singly does not do this by default. Your
URL will look like:
Then for some
page_id that your user manages to,
fromThe profile you wish to share as.
LinkedIn users can send messages to their connections.
To send a message, your application must request the
during authorization. (See LinkedIn's
for a full description of permissions.) Singly will pass this permission through
scope query parameter:
Then to message a user,
toThe user who should receive the message. This is the application-specific user ID reported by an endpoint like /friends/linkedin. It is not the user's global LinkedIn ID, nor is it their custom URL nickname.
titleThe subject line of the message
bodyThe contents of the message
Twitter users can send a Direct Message to anyone who follows them.
In order to send Direct Messages, your application must be set to "Read,
Write and Access direct messages" on your Twitter application configuration
page. During user authorization, you must also pass
To send a Direct Message, specify a Twitter user in the
Users may have multiple blogs hosted on Tumblr, so simply specifying
to=tumblr is not specific enough. Instead, specify
If the blog is hosted on Tumblr (eg, apijoy.tumblr.com), the subdomain is enough:
If the blog has a custom domain, you must include the full hostname:
Messages are sent between specific users of a service. Because of the one-to-one
nature of messages, most services require that the user grant your application
a special permission, for example the Direct Message permission on Twitter or
w_messages permission on LinkedIn.
toThe Twitter or LinkedIn user who should receive the message, including the service name (
beaugunderson@twitter, for example).
titleThe subject line of the message (when applicable).
bodyThe contents of the message.
Statuses are simple text updates like a tweet or a Facebook status.
bodyThe text of the status to share
News links are URLs to content on the web, like a blog post.
bodyText describing the link
bodytext does not already contain the link, it will be appended.
tumblrNews is posted as a new blog post. If you include a
title, it becomes the text of the link. Otherwise, the post displays the URL.
Photos are pictures taken by your users.
photoThe photo you wish to upload
body(Optional) Text describing the photo (not currently supported by Tumblr)
tumblrPhotos are uploaded as a new post.
Facebook's Open Graph allows you to publish actions your user takes to their activity stream on Facebook. Common examples include reading an article or listening to a song, and your application can define custom actions and objects for your users to interact with.
This endpoint is distinct from the rest, since it applies only to Facebook. For full details and options, see Facebook's documentation.
:actionThe Open Graph action your user is performing. It could be a built-in action like
music.listensor one of your app's custom actions, for example