Messages

Retrieve message

Retrieves a message. A message is always associated with a single social profile. Messages might be unavailable for a brief time during upload to social networks.

get/v1/messages/{messageId}

Request

  • Base URL
    https://platform.hootsuite.com
  • URL
    https://platform.hootsuite.com/v1/messages/{messageId}
  • Auth
    OAuth 2
    Authorization code: https://platform.hootsuite.com/oauth2/auth
    Token URL: https://platform.hootsuite.com/oauth2/token

Path parameters

messageIdstring required

The message ID.

Headers

Authorizationstring required

A bearer token string used for authentication

Response

Success

Example response

{
  "data": {
    "id": "4138476039",
    "state": "SCHEDULED",
    "text": "5 trends that will change how we use social media this year http://owl.li/YuNr2",
    "socialProfile": {
      "id": "115185509",
      "externalURL": "https://www.linkedin.com/in/l-lhs-8654321"
    },
    "scheduledSendTime": "2018-10-25T10:35:00.000Z",
    "webhookUrls": [
      "https://myserver.com/inbound"
    ],
    "tags": [
      "test_tag"
    ],
    "targeting": {
      "facebookPage": {
        "ageMin": 45,
        "education": [
          "collegeGrad"
        ],
        "interestedIn": [
          "female"
        ],
        "relationshipStatus": [
          "single"
        ],
        "countries": [
          {
            "k": "Canada",
            "v": "CA"
          }
        ],
        "regions": [
          {
            "k": "British Columbia",
            "v": "2"
          }
        ],
        "cities": [
          {
            "k": "Burnaby, BC",
            "v": "292466"
          }
        ],
        "zips": [
          {
            "k": "K1S",
            "v": "CA:K1S"
          }
        ]
      },
      "linkedInCompany": {
        "companySize": [
          "51-200"
        ],
        "geography": [
          "as.jp"
        ],
        "industry": [
          "41"
        ],
        "jobFunction": [
          "qa"
        ],
        "seniority": [
          "en"
        ]
      }
    },
    "privacy": {
      "facebook": {
        "visibility": [
          "everyone"
        ]
      },
      "linkedIn": {
        "visibility": [
          "anyone"
        ]
      }
    },
    "location": {
      "latitude": 57.64911,
      "longitude": 10.40744
    },
    "emailNotification": true,
    "mediaUrls": [
      {
        "thumbnailUrl": "http://static.ow.ly/photos/thumb/cS5.jpg",
        "url": "http://static.ow.ly/photos/normal/cS5.jpg"
      }
    ],
    "media": [
      {
        "id": "aHR0cDovL2V4YW1wbGUub3Jn",
        "thumbnailId": "aHR0cDovL2V4YW1wbGUtMDAwMS5vcmc=",
        "videoOptions": {
          "facebook": {
            "title": "My Video",
            "category": "ENTERTAINMENT"
          }
        }
      }
    ],
    "extendedInfo": [
      {
        "socialProfileType": "PINTEREST",
        "socialProfileId": "123456789",
        "data": {
          "boardId": "123456789012345678",
          "destinationUrl": "https://www.hootsuite.com"
        }
      }
    ],
    "postId": "705207140236001282",
    "postUrl": "https://www.facebook.com/177463958820/posts/10155617296368821",
    "createdByMember": {
      "id": "1389211223"
    },
    "lastUpdatedByMember": {
      "id": "1389211222"
    },
    "sequenceNumber": 3,
    "reviewers": [
      {
        "type": "MESSAGE_LEVEL"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.