Skip to main content
POST

Authorizations

Authorization
string
header
required

Pass Authorization: Bearer <credential>, where the credential is either:

  • an API key (sk_…), generated by an organization admin in Settings, for scripts and automation;
  • an access token from tth auth login (the TalkToHumans CLI), which any member of the workspace can use.

Both resolve to the same organization and user. A login token acts in the user's workspace: one with no workspace yet returns 403 workspace_setup_required, and one in several workspaces returns 403 forbidden (use an API key instead).

Body

application/json
account_id
string
required

LinkedIn account ID returned by GET /v1/accounts.

Pattern: ^[1-9][0-9]*$
content_id
string

A post's content ID from GET /v1/content. Provide exactly one of content_id or linkedin_url.

linkedin_url
string

A LinkedIn post URL. A post not yet in TalkToHumans is imported first, for 1 credit. Provide exactly one of content_id or linkedin_url.

include_reactions
boolean
deprecated

Ignored. The people who reacted are always imported with the commenters.

estimate_only
boolean
default:false

Return estimated_credits without importing or spending anything. Needs a post already in TalkToHumans.

Response

The estimate, or nothing new to import (import_id is null).

data
object
required