Scheduling Posts
Post Tags
Learn how to query post tags to organize your scheduled content using the Postpone API.
Post Tags
Post tags allow you to organize and categorize your scheduled posts. You can query your post tags via the API to use them when scheduling posts across any platform.
Post tags are referenced by their ID when scheduling posts. Use the
postTags query to retrieve your available tags and their IDs.Query
Use the postTags query to retrieve all post tags for your account:
query postTags($activeOnly: Boolean) {
postTags(activeOnly: $activeOnly) {
id
name
color
dateArchived
dateCreated
dateUpdated
}
}
Parameters
activeOnly
Boolean
When
true, returns only active (non-archived) tags. When false, returns all tags including archived ones. Defaults to true.Response Fields
id
ID!
The unique identifier for the post tag. Use this ID when assigning tags to scheduled posts.
name
String!
The display name of the tag.
color
String!
The hex color code associated with the tag (e.g.,
#FF5733).dateArchived
DateTime
The date when the tag was archived, or
null if the tag is active.dateCreated
DateTime!
The date when the tag was created.
dateUpdated
DateTime!
The date when the tag was last updated.
Examples
Get All Active Tags
query {
postTags {
id
name
color
}
}
Response:
{
"data": {
"postTags": [
{
"id": "123",
"name": "Product Launch",
"color": "#4CAF50"
},
{
"id": "456",
"name": "Blog Content",
"color": "#2196F3"
}
]
}
}
Using Tags When Scheduling Posts
When scheduling posts to any platform, you can include the postTags parameter with an array of tag IDs:
mutation ScheduleTweet($input: ScheduleTweetInput!) {
scheduleTweet(input: $input) {
success
errors {
message
}
}
}
Variables
{
"input": {
"username": "myhandle",
"postAt": "2025-12-15T14:30:00.000Z",
"thread": [{ "text": "Check out our new product!", "order": 0 }],
"postTags": ["123", "456"]
}
}
The
postTags parameter accepts an array of post tag IDs. You can assign multiple tags to a single post.