find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/creatorriver-com:creatorriver-com-conversations-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Creatorriver Com Conversations API
  version: '1'
  description: 'Operations tagged conversations across 2 of this provider''s published API definitions: creatorriver-com-openapi.json, creatorriver-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://www.creatorriver.com/api/v1
security:
- apiKey: []
tags:
- name: Conversations
paths:
  /campaigns/{campaignId}/creators/{creatorId}/conversation:
    get:
      operationId: get_conversation
      summary: Read the email conversation with a creator
      description: 'Returns the email thread with a creator in a campaign: its stage, who it is waiting on, the next action and agreed facts, plus every message and event, oldest first. Free. Check it for replies after send_email. The thread is null until the first email is sent.'
      tags:
      - Conversations
      parameters:
      - name: campaignId
        in: path
        required: true
        description: Campaign id, from list_campaigns or create_campaign
        schema:
          type: string
          minLength: 1
          description: Campaign id, from list_campaigns or create_campaign
      - name: creatorId
        in: path
        required: true
        description: Creator id, from search_creators results
        schema:
          type: string
          minLength: 1
          description: Creator id, from search_creators results
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data: {}
                required:
                - data
        4XX:
          description: Failure; `error.code` says what to do
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        5XX:
          description: Failure; `error.code` says what to do
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
    servers:
    - url: https://www.creatorriver.com/api/v1
  /campaigns/{campaignId}/creators/{creatorId}/replies:
    post:
      operationId: record_reply
      summary: Record a reply the creator sent outside Creator River
      description: Records a reply that reached the user some other way (a DM, another inbox, a call) and how it went. positive or neutral moves the creator to negotiation (a confirmed collaboration stays), waiting on the user; negative records that they declined and closes the conversation. Free. Replies to emails sent with send_email arrive on their own (see get_conversation), so never record those. Needs an email sent first. Recording the same reply again changes nothing.
      tags:
      - Conversations
      parameters:
      - name: campaignId
        in: path
        required: true
        description: Campaign id, from list_campaigns or create_campaign
        schema:
          type: string
          minLength: 1
          description: Campaign id, from list_campaigns or create_campaign
      - name: creatorId
        in: path
        required: true
        description: Creator id, from search_creators results
        schema:
          type: string
          minLength: 1
          description: Creator id, from search_creators results
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                disposition:
                  type: string
                  enum:
                  - positive
                  - neutral
                  - negative
                  description: 'How the reply went: positive (interested), neutral, or negative (declined)'
                summary:
                  type: string
                  minLength: 1
                  maxLength: 5000
                  description: What the creator said, quoted or in a sentence
                price:
                  description: Price the creator named or agreed, as said, e.g. $300 per video
                  type: string
                  minLength: 1
                  maxLength: 200
                liveWindow:
                  description: When the content would go live, as said, e.g. late March
                  type: string
                  minLength: 1
                  maxLength: 200
              required:
              - disposition
              - summary
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data: {}
                required:
                - data
        4XX:
          description: Failure; `error.code` says what to do
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        5XX:
          description: Failure; `error.code` says what to do
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
    servers:
    - url: https://www.creatorriver.com/api/v1
  /campaigns/{campaignId}/creators/{creatorId}/collaboration:
    post:
      operationId: confirm_collaboration
      summary: Record that a creator agreed to collaborate
      description: Records that the creator agreed to work with the user, with the agreed terms, and moves them to the collaboration stage, waiting on the user to prepare it. Free. Call it only once the creator has clearly said yes to the terms; it sends nothing to the creator. Needs an email sent first. Confirming the same terms again changes nothing.
      tags:
      - Conversations
      parameters:
      - name: campaignId
        in: path
        required: true
        description: Campaign id, from list_campaigns or create_campaign
        schema:
          type: string
          minLength: 1
          description: Campaign id, from list_campaigns or create_campaign
      - name: creatorId
        in: path
        required: true
        description: Creator id, from search_creators results
        schema:
          type: string
          minLength: 1
          description: Creator id, from search_creators results
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                terms:
                  type: string
                  minLength: 1
                  maxLength: 5000
                  description: 'What was agreed: deliverables, fee, dates, usage'
                deliverables:
                  description: Each agreed deliverable, e.g. one 60-second integration
                  maxItems: 20
                  type: array
                  items:
                    type: string
                    minLength: 1
                    maxLength: 500
                price:
                  description: Price the creator named or agreed, as said, e.g. $300 per video
                  type: string
                  minLength: 1
                  maxLength: 200
                liveWindow:
                  description: When the content would go live, as said, e.g. late March
                  type: string
                  minLength: 1
                  maxLength: 200
              required:
              - terms
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data: {}
                required:
                - data
        4XX:
          description: Failure; `error.code` says what to do
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        5XX:
          description: Failure; `error.code` says what to do
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
    servers:
    - url: https://www.creatorriver.com/api/v1
components:
  schemas:
    Error:
      type: object
      required:
      - error
      properties:
        error:
          type: object
          required:
          - code
          - message
          properties:
            code:
              type: string
              enum:
              - unauthorized
              - not_found
              - invalid_input
              - insufficient_credits
              - rate_limited
              - conflict
              - internal
            message:
              type: string
            details:
              type: object
            requestId:
              type: string
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: An API key from https://www.creatorriver.com/settings/apikeys
x-refined-from:
- creatorriver-com-openapi.json
- creatorriver-com-openapi.yml