Skip to content
Content Publishing
/
Fetch content replications

Firstup API (v2)

Beta Notice: This portal is currently in beta. Some functionality, like Try it is temporarily disabled.


API Concepts and Overview

Each API concept can be found in our Docs; we give an overview of each API, the expected behavior and what is possible.

Technical details are found in this reference, but some complex technicalities are further explained in our docs.

Further technical guidance on SCIM patching, pagination and filtering can be found in our docs:

Technical Details

From this page you can download the OpenAPI specification for the Firstup API. This can be imported into tools such as Postman to generate a collection of test queries or converted into an SDK using Swagger Codegen. Alternatively, you can use the try me function in this platform.

Authorization

All API endpoints use the JSON content type and require an auth token. See Authentication and Authorization for more details on token management. The token and content type should be explicitly set in the request headers. For example: 

  curl -X GET "https://partner.socialchorus.com/v2/channels" -H "accept: application/json" -H "Authorization: Bearer <ACCESS TOKEN>"
Main API Sections

Firstup Developer Portal
Download OpenAPI description
openapi.json
openapi.yaml
Overview
URL

https://support.firstup.io/hc/en-us

Terms of Service

Languages
Servers

https://developers.firstup.io/

Content Publishing

The Content Publishing API provides access to content the same way Program Studio does, enabling the creation and updating of articles, links, videos, and images.

  • Security: Users with a “publisher” or higher role can work with content in this admin-like function. A 403 code is returned for content-related requests to users without a “publisher” or higher role. Permissions are not granular; any authenticated user may read, update, or take action on any existing content. See user roles and access for more guidance.

  • States: Content is initially created in the “draft” state. It becomes fully visible in feeds when it has passed the “review” state (meaning that it requires review) and is in the “published” state. Content can also pass through “archived” (similar to deleted), “scheduled” (content to be published in the future automatically), “processing” (refers to media that is still being processed or uploaded; like content in the “draft” state, this content does not become “published” until processing has completed), and “processing error” (media or similar objects that fail during the processing phase; this content cannot be transitioned to another state) states.

  • Sources: Content sources include “submitted” (by users); “Pinterest,”“RSS,”“Facebook,”“Twitter,” and “Instagram” (for content harvested from external sources); “SocialChorus CPCM” (for content that is republished between programs); “studio” (for admin-created content); and “OAuth Client” (for content published via the Partner API or other OAuth client).

For contextual guidance on content publishing, and for use case examples, refer to our Content Publishing Overview page.

Operations

Remove an image from a content post

Request

Remove an image from a content record. Images cannot be removed from published content. Response status for removed content is 204 No Content.

Security
oauth2_as_a_user or oauth2_as_a_server
Path
content_idintegerrequired

ID or UUID of the content post

content_image_idintegerrequired

ID of the content image

curl -i -X DELETE \
  'https://developers.firstup.io/v2/content/{content_id}/images/{content_image_id}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Success

Response
No content

Fetch content replications

Request

The endpoint allow users to get details of content replication. Source or target filter is required

Security
oauth2_as_a_user or oauth2_as_a_server
Query
filter.source.contentIdinteger

ID of source content. If present then source platform should also be present

filter.source.platformstring

Source platform type. If present then source content ID should also be present

Enum"firstup""slack""sharepoint"
filter.target.contentIdstring

ID of published content. If present then target platform should also be present

filter.target.platformstring

Target platform type. If present then target content ID should also be present

Enum"firstup""slack""sharepoint"
filter.workflowIdstring

ID of workflow

curl -i -X GET \
  'https://developers.firstup.io/v2/content/replications?filter.source.contentId=0&filter.source.platform=firstup&filter.target.contentId=string&filter.target.platform=firstup&filter.workflowId=string' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Success

Bodyapplication/json
dataArray of objectsrequired
data[].​sourceContentIdstring
data[].​sourcePlatformstring
data[].​targetContentIdstring
data[].​targetPlatformstring
data[].​replicatedAtstring
data[].​targetLocationIdstring
data[].​workflowIdinteger
Response
application/json
"[{\n  \"sourceContentId\": \"3\",\n  \"sourcePlatform\": \"firstup\",\n  \"targetContentId\": \"1\",\n  \"targetPlatform\": \"firstup\",\n  \"replicatedAt\": \"2000-01-01T00:00:00Z\",\n  \"targetLocationId\": \"10\",\n  \"workflowId\": 2\n}, {\n  \"sourceContentId\": \"4\",\n  \"sourcePlatform\": \"firstup\",\n  \"targetContentId\": \"723\",\n  \"targetPlatform\": \"slack\",\n  \"publicationDate\": \"2020-01-01T00:00:00Z\",\n  \"targetLocationId\": \"47\",\n  \"workflowId\": 7\n}]\n"

Get a download URL for a content video

Request

Returns a temporary link to a content video.

Security
oauth2_as_a_user or oauth2_as_a_server
Path
video_idintegerrequired

ID of the video

Query
lifespaninteger(int32)

Number of seconds the link should remain valid from the time it is generated

curl -i -X GET \
  'https://developers.firstup.io/v2/videos/{video_id}/download?lifespan=0' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Success

Bodyapplication/json
dataobjectrequired
data.​video_idinteger

ID of the video

Example: 628
data.​download_urlstring
Example: "https://cdn.example.com/acme/acmetimes/video/cab13"
Response
application/json
{
  "data": {
    "video_id": 628,
    "download_url": "https://cdn.example.com/acme/acmetimes/video/cab13"
  }
}

Feeds

The Feeds API provides access to lists of content similar to how a user sees them in the Firstup experience application. Feeds are specific to the authenticated user and a user can only see what the platform gives them access to.

At their core, feeds are built using filters to find the exact topics and type of posts your application wishes to expose to its users. One of the basic filters is the channels.id filter, but there are additional filters like content_type and visibility. There are also preset configurations called named feeds, which uses the name query parameter and are convenient wrappers around a set of filters. These include things like "trending" posts, "following", and "myfeed". The full list of feed names is outlined in the listFeedPosts documentation.

Feeds are paginated, but have no total records as they are an inherently dynamic list of posts.

Actions like liking, bookmarking, and responding to polls can be taken on individual posts in the same way they can be taken on the experience applications.

For contexctual guidance on feeds, and for use examples, refer to our feeds overview page.

Operations

User Management

The User Management API adheres to the SCIM 2.0 protocol unless otherwise stated, and provides management and provisioning of users in a program.

Managing users requires that the acting user have a role of Program Manager or Administrator, and users can only create or update users with a role less than or equal to their own.

For further guidance on User Management, refer to:

Operations

User Groups

The Group Management API adheres to the SCIM 2.0 protocol unless otherwise stated, and provides management and provisioning of Groups and its members (Users) within a Program.

Managing Groups requires that the acting User have a role of Program Manager or Administrator, and Group read and/or write access.

Note: User groups are SCIM groups only. Currently this API does not support creating audiences.

Operations

Webhooks

The Webhooks API provides a mechanism for subscribing to events that occur within the Firstup platform to receive http payloads when those events occur. Use webhook subscriptions to trigger actions on your own application.

Webhook events are sent by the Firstup platform as POST requests to your webhook url. Each event contains a payload specific to that event. More information about the webhooks system, including a list of events that can be subscribed to, is available on the Webhooks page.

Operations

Assistant Inbox

Note: This API is getting deprecated and is replaced by the Notification Center.

Operations

User Roles

Operations

Notification Center

Operations