GET /sites/$site/publicize-connections/

Get a list of publicize connections that are associated with the specified site.

Resource Information

Method GET
Requires authentication? Yes

Method Parameters

Query Parameters

Response Parameters

Resource Errors

These are the possible errors returned by this endpoint.

HTTP Code Error Identifier Error Message
400 invalid_input Please provide a valid numeric publicize connection ID
403 authorization_required Access token does not have the required scope
403 authorization_required This user is not authorized to modify this publicize connection.
403 authorization_required An active access token must be used to access publicize connections.
400 deletion_error This connection could not be deleted.
403 authorization_required This user is not authorized to access publicize connections on this site.
400 invalid_input Please provide at least one property to update for this connection
400 incompatible_jetpack Please upgrade Jetpack to version 3.3 or newer in order to access this endpoint.
403 authorization_required This user is not authorized to globalize this publicize connection.
400 missing_jetpack_module The Publicize module must be activated in order to use this endpoint.


curl \
 -H 'authorization: Bearer YOUR_API_TOKEN' \
$options  = array (
  'http' => 
  array (
    'ignore_errors' => true,
    'header' => 
    array (
      0 => 'authorization: Bearer YOUR_API_TOKEN',

$context  = stream_context_create( $options );
$response = file_get_contents(
$response = json_decode( $response );


    "ID": 1234567,
    "site_ID": 3584907,
    "user_ID": 12345678,
    "keyring_connection_ID": 1234567,
    "keyring_connection_user_ID": 12345678,
    "shared": false,
    "service": "twitter",
    "label": "Twitter",
    "issued": "2014-08-2302:49:47",
    "expires": "0000-00-0000:00:00",
    "external_ID": "15919116",
    "external_name": "Automattic",
    "external_display": "@automattic",
    "external_profile_picture": "https:\/\/\/profile_images\/453860857923923968\/Rg_FuLjK_400x400.png",
    "external_profile_URL": "http:\/\/\/automattic",
    "external_follower_count": 24103,
    "status": "ok",
    "refresh_URL": "https:\/\/\/connect\/?action=request&kr_nonce=xxxxxxxxxx&nonce=xxxxxxxxxx&refresh=1&for=connect&service=twitter&kr_blog_nonce=xxxxxxxxxx&magic=keyring&blog=3584907",
    "meta": {
        "links": {
            "self": "https:\/\/\/rest\/v1.1\/sites\/3584907\/publicize-connections\/1234567",
            "help": "https:\/\/\/rest\/v1.1\/sites\/3584907\/publicize-connections\/1234567\/help",
            "site": "https:\/\/\/rest\/v1.1\/sites\/3584907",
            "service": "https:\/\/\/rest\/v1.1\/meta\/external-services\/twitter",
            "keyring-connection": "https:\/\/\/rest\/v1.1\/me\/keyring-connections\/1234567"