Profiles

A Buffer profile represents a connection to a single social media account.

GET /profiles

Returns an array of social media profiles connected to a users account.

Example Request

GET https://api.bufferapp.com/1/profiles.json
[ { 
    "avatar" : "http://a3.twimg.com/profile_images/1405180232.png",
    "created_at" :  1320703028,
    "default" : true,
    "formatted_username" : "@skinnyoteam",
    "id" : "4eb854340acb04e870000010",
    "schedules" : [{ 
        "days" : [ 
            "mon",
            "tue",
            "wed",
            "thu",
            "fri"
        ],
        "times" : [ 
            "12:00",
            "17:00",
            "18:00"
        ]
    }],
    "service" : "twitter",
    "service_id" : "164724445",
    "service_username" : "skinnyoteam",
    "statistics" : { 
        "followers" : 246 
    },
    "team_members" : [
        "4eb867340acb04e670000001"
    ],
    "timezone" : "Europe/London",
    "user_id" : "4eb854340acb04e870000010"
  },
  {
	...
  }
]

GET /profiles/:id

Returns details of the single specified social media profile.

Example Request

GET https://api.bufferapp.com/1/profiles/4eb854340acb04e870000010.json
{ 
  "avatar" : "http://a3.twimg.com/profile_images/1405180232.png",
  "created_at" :  1320703028,
  "default" : true,
  "formatted_username" : "@skinnyoteam",
  "id" : "4eb854340acb04e870000010",
  "schedules" : [{ 
      "days" : [ 
          "mon",
          "tue",
          "wed",
          "thu",
          "fri"
      ],
      "times" : [ 
          "12:00",
          "17:00",
          "18:00"
      ]
  }],
  "service" : "twitter",
  "service_id" : "164724445",
  "service_username" : "skinnyoteam",
  "statistics" : { 
      "followers" : 246 
  },
  "team_members" : [
      "4eb867340acb04e670000001"
  ],
  "timezone" : "Europe/London",
  "user_id" : "4eb854340acb04e870000010"
}

GET /profiles/:id/schedules

Returns details of the posting schedules associated with a social media profile.

Example Request

GET https://api.bufferapp.com/1/profiles/4eb854340acb04e870000010/schedules.json
[{ 
  "days" : [ 
      "mon",
      "tue",
      "wed",
      "thu",
      "fri"
  ],
  "times" : [ 
      "12:00",
      "17:00",
      "18:00"
  ]
},
{
  ...
}]

POST /profiles/:id/schedules/update

Set the posting schedules for the specified social media profile.

Parameters

schedules required array Each item in the array is an individual posting schedule which consists of days and times to match the format return by the above method.

Example Request

POST https://api.bufferapp.com/1/profiles/4eb854340acb04e870000010/schedules/update.json

POST Data
    schedules[0][days][]=mon&
    schedules[0][days][]=tue&
    schedules[0][days][]=thu&
    schedules[0][times][]=12:45&
    schedules[0][times][]=15:30&
    schedules[0][times][]=17:43&
{
    "success": true
}
Get in Touch Submit an Idea