Oktopost
Publishing

Tags

Organize and categorize campaigns and messages for better analytics and reporting in Social BI.

Tags are labels you can assign to campaigns and messages to organize your content and enable advanced filtering in Social BI analytics. Use tags to categorize content by theme, product line, audience segment, or any custom taxonomy that fits your workflow. Tagged content can be analyzed and reported on separately, providing insights into specific content categories or marketing initiatives.

Tags assigned to campaigns and messages are available as filters in Social BI, allowing you to segment analytics and measure performance by specific content categories.

List Tags

Parameters

ParameterTypeRequiredDescription
_orderStringNoSort order for results. Accepted values: tag, created, lastUsed
_pageIntegerNoPage number for pagination.
_countIntegerNoNumber of items to return per page.

Example Request

curl -i https://api.oktopost.com/v2/tag

Example Result

{
	"Result": true,
	"Items": [
		{
			"Id": "0AF000000000001",
			"Created": "2020-11-03 08:35:30",
			"Tag": "Hello",
			"LastUsedDate": "2020-11-03 08:48:34"
		},
		{
			"Id": "0AF000000000002",
			"Created": "2020-11-03 08:35:30",
			"Tag": "World",
			"LastUsedDate": "2020-11-03 08:52:31"
		}
	],
	"Total": 2
}

Get Tag

Example Request

curl -i https://api.oktopost.com/v2/tag/0AF000000000001

Example Result

{
	"Result": true,
	"Tag":{
		"Id": "0AF000000000001",
		"Created": "2020-11-03 08:35:30",
		"Tag": "Hello",
		"LastUsedDate": "2020-11-03 08:48:34"
	}
}

Add Tag

Example Request

curl -i https://api.oktopost.com/v2/tag -X POST \
    -d tag="Tag Name"

Example Result

{
	"Result": true,
	"Tag": {
		"Id": "0AF000000000001",
		"Created": "2020-11-03 08:35:30",
		"Tag": "Tag Name",
		"LastUsedDate": "2020-11-03 08:48:34"
	}
}

Update Tag

Example Request

curl -i https://api.oktopost.com/v2/tag/0AF000000000001 -X POST \
    -d tag="My Tag"

Example Result

{
	"Result": true,
	"Tag": {
		"Id": "0AF000000000001",
		"Created": "2020-11-03 08:35:30",
		"Tag": "Tag Name",
		"LastUsedDate": "2020-11-03 08:48:34"
	}
}

Delete Tag

Example Request

curl -i https://api.oktopost.com/v2/tag/0AF000000000001 -X DELETE