Social Profiles

View and manage connected social media accounts, including personal profiles, company pages, and groups.

Social profiles are the social media accounts connected to Oktopost, including personal profiles, company pages, and groups from networks like LinkedIn, X, Facebook, Instagram, and YouTube. These profiles serve as the publishing destinations for your posts and the sources for engagement data. Use these endpoints to retrieve profile information, check connection status, and manage your connected accounts.

Social profiles must be connected through the Oktopost platform interface before they can be accessed via the API. Use these endpoints to retrieve and manage profiles that are already connected.

Get a single social profile by Id.

Example Request

curl -i https://api.oktopost.com/v2/credential/003-001000000000000-10795428XXXXXXXXX

Example Result

{
    "Result":true,
    "Credential":{
        "Id":"003-001000000000000-10795428XXXXXXXXX",
        "Created":"2015-10-26 21:02:30",
        "Name":"Oktopost's Twitter",
        "DisplayName":"Oktopost",
        "Status":"valid",
        "Network":"Twitter",
        "ImageLink":"valid",
        "NetworkUsername":"oktopost",
        "NativePostsEnabled":0
    }
}

Example Request

curl -i https://api.oktopost.com/v2/credential?network=Twitter&includeInvalid=0

Parameters

Results can be filtered by network. Acceptable values are: LinkedIn, Twitter, YouTube, Instagram, Facebook, WeChat, Xing, and TikTok.

Param	Default	Optional	Description
network	-	√	Acceptable values are: LinkedIn, Twitter, YouTube, Instagram, Facebook, WeChat, Xing, and TikTok.
includeInvalid	0	√	If set to 1, the response will include invalid credentials.

Example Result

{
"Result":true,
    "Items":[{
        "Id":"003-001000000000000-10795428XXXXXXXXX",
        "Created":"2015-10-26 21:02:30",
        "Name":"Oktopost's Twitter",
        "DisplayName":"Oktopost",
        "Status":"valid",
        "Network":"Twitter",
        "ImageLink":"valid",
        "NetworkUsername":"oktopost",
        "NativePostsEnabled":0
    },
    ...
    ],
    "Total":21
}

Update a single social profile by Id.

Example Request

curl -i https://api.oktopost.com/v2/credential/003-001000000000000-10795428XXXXXXXXX -X PUT \
-d displayName="Oktopost Twitter" \
-d nativePostsEnabled=1

Example Response

{
    "Result": true,
    "Credential": {...}
}

Deleting a profile will delete all scheduled posts using it.

Example Request

curl -i https://api.oktopost.com/v2/credential/003-001000000000000-10795428XXXXXXXXX -X DELETE

List Targeting Presets

Retrieve available targeting presets for a LinkedIn Company Page credential. Presets define audience targeting criteria (company size, industry, job function, seniority, geography, language) that can be applied when creating or updating posts via targetingPresetId.

Example Request

curl -i https://api.oktopost.com/v2/credential/003-001000000000000-12345678/targeting-presets

Parameters

Param	Default	Description
_page	0	The current page
_count	25	Results per page (1–100)

Example Response

{
    "Result": true,
    "Items": [
        {
            "Id": "0tp000000000001",
            "CredentialId": "003-001000000000000-12345678",
            "AccountId": "001000000000000",
            "Name": "Enterprise Decision Makers",
            "CompanySize": ["10001+"],
            "Industry": ["Software"],
            "Function": ["Engineering"],
            "Seniority": ["Director", "VP"],
            "Geography": ["United States"],
            "Language": ["en"]
        }
    ],
    "Total": 1
}

Error Responses

Status	Condition
400	Credential is not a LinkedIn Company Page

On this page