POST login/users/:user id/notifications/facebook

Description

Posts a Facebook notification to the user.

Read the documentation about Facebook Notifications at https://developers.facebook.com/docs/games/notifications to understand how to use this API, the limitations and best practices. Important details:

• Facebook Apps must have Canvas Page configured.
• Facebook Apps can send notifications only to people who have authorized the app.
• No special or extended Facebook permission is required.
• Facebook Apps that send more than 50,000 notifications in a week are required to maintain at least a 17% weekly click-to-impression (CTI) ratio.
• Best practices: https://developers.facebook.com/docs/games/notifications#best_practices

Resource URL

  POST https://api.socialidnow.com/v1/marketing/login/users/:user_id/notifications/facebook

Parameters

URL Parameters

user_id	required	user identifier.

JSON Parameters

notification	required	a hash with the necessary fields to post the notification:
template	required	The message text of the notification. This can be formatted according to special text templating. Maximum of 180 characters.
href	optional	The relative path that someone clicking on the notification will be directed to. This is will be appended to the Facebook app's canvas URL.
ref	optional	Separate your notifications into groups so they can be tracked independently in Facebook App Analytics.

Authentication

This API requires Login App authentication. See Authentication.

Response

Response Status

accepted (202)	The request was accepted and will be processed.
bad_request (400)	The parameters are missing or invalid.
unauthorized (401)	The authentication is wrong. See Authentication.
internal_server_error (500)	An unknown error happened.

Examples

Request

 curl -iX POST 'https://api.socialidnow.com/v1/marketing/login/users/340/notifications/facebook' \
        -d '{"notification": {"template": "Visit Social-ID NOW",
                              "href": "/visit/campaign" }}' \
        -H 'Content-type: application/json' \
        --user 138:e8b9ca24f1b590af67e6271297d6e1f7226625d61c5b5daa1b2f215464e292cf

Response

Response Headers

HTTP/1.1 202 Accepted
Status: 202