Mavrck Activations API

openapi: 3.2.0
info:
  version: 1.0.0
  description: Identify your most influential customers and activate them to drive more conversions on social.
  title: MAVRCK.IO Activations API
servers:
- url: http://app.splashscore.com/v1
- url: https://app.splashscore.com/v1
security:
- apiKey: []
tags:
- name: Activations
paths:
  /action/{actionId}/activation:
    post:
      tags:
      - Activations
      x-handler: activations/action_activation_controller.js
      x-access:
      - influencer
      summary: Create an activation when an action is completed by a user.
      parameters:
      - name: actionId
        in: path
        required: true
        schema:
          type: string
      - name: productExperience
        in: query
        required: false
        description: Tag this activation with a key denoting the experience/channel in which the user created the activation.
        schema:
          type: string
      - name: utmSource
        in: query
        required: false
        schema:
          type: string
      - name: utmMedium
        in: query
        required: false
        schema:
          type: string
      - name: utmTerm
        in: query
        required: false
        schema:
          type: string
      - name: utmContent
        in: query
        required: false
        schema:
          type: string
      - name: utmCampaign
        in: query
        required: false
        schema:
          type: string
      - name: iovationIdentifier
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Activation URIs
          content:
            application/json:
              schema:
                type: object
                properties:
                  meta:
                    $ref: '#/components/schemas/ResponseMetadata'
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/ActivationURI'
        '400':
          description: Action not completed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Session expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Action already completed by this influencer.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Action not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      requestBody:
        content:
          application/json:
            schema:
              type: object
  /action/{actionId}/activations:
    get:
      tags:
      - Activations
      operationId: getActionActivations
      x-handler: activations/action_activation_controller.js
      x-access:
      - administrator
      - root
      - influencer
      summary: Retrieve activations for an action.
      parameters:
      - $ref: '#/components/parameters/orderByParam'
      - $ref: '#/components/parameters/limitParam'
      - $ref: '#/components/parameters/offsetParam'
      - $ref: '#/components/parameters/approvalStatus'
      - name: actionId
        in: path
        required: true
        schema:
          type: string
      - name: minStars
        in: query
        required: false
        description: Filter on minimum stars.
        schema:
          type: integer
      - name: myActivations
        in: query
        description: As an influencer, select only my activations associated with the action.
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: Collection of activations.
          content:
            application/json:
              schema:
                type: object
                properties:
                  meta:
                    $ref: '#/components/schemas/ResponseMetadata'
                  data:
                    items:
                      $ref: '#/components/schemas/ActivationDeprecated'
                    type: array
        '400':
          description: Invalid parameter.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Session expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Action not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /action-groups/{actionGroupId}/activations:
    get:
      tags:
      - Activations
      operationId: getActionGroupActivations
      x-handler: activations/action_group_activation_controller.js
      x-access:
      - administrator
      - influencer
      - shared-cipher
      x-sharedCipherParameters:
        actionGroupId: actionGroupId
      summary: Fetch all activations for an action group
      parameters:
      - name: actionGroupId
        in: path
        required: true
        schema:
          type: integer
      - name: globalUserId
        in: query
        description: The global user Id to filter the results by.
        schema:
          type: integer
      - name: myActivations
        in: query
        description: Flag permitting the influencer to view unapproved and/or-only approved activations
        schema:
          type: boolean
      - $ref: '#/components/parameters/limitParam'
      - $ref: '#/components/parameters/offsetParam'
      - $ref: '#/components/parameters/postsWithUGC'
      - $ref: '#/components/parameters/networkParam'
      - $ref: '#/components/parameters/userFilter'
      - $ref: '#/components/parameters/orderDirection'
      - name: orderProperty
        in: query
        schema:
          type: string
          enum:
          - postDate
          - createdAt
          - engagements
          - estimatedImpressions
      - name: networks
        in: query
        description: Array of networks
        schema:
          type: array
          items:
            type: string
      - name: postDateAfter
        in: query
        description: The activation post date is >= this date
        schema:
          type: string
      - name: postDateBefore
        in: query
        description: The activation post date is <= this date
        schema:
          type: string
      - name: filterTagIds
        in: query
        description: Array of tag ids used for searching activations
        schema:
          type: array
          items:
            type: number
      - name: tagQuantifier
        in: query
        description: any or all option when searching for filterTagIds
        schema:
          type: string
      - name: shouldExportFilenames
        in: query
        description: Whether or not to export the filenames of the activations
        schema:
          type: boolean
      responses:
        '200':
          description: An array of activations.
          content:
            application/json:
              schema:
                type: object
                properties:
                  meta:
                    $ref: '#/components/schemas/ResponseMetadata'
                  data:
                    items:
                      $ref: '#/components/schemas/ActivationDeprecated'
                    type: array
        '400':
          description: Invalid/missing parameter
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Session expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Invalid API Key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /activations:
    get:
      tags:
      - Activations
      operationId: getActivations
      x-handler: activations/activation_controller.js
      x-access:
      - influencer
      - administrator
      summary: Fetch all activations
      parameters:
      - $ref: '#/components/parameters/limitParam'
      - $ref: '#/components/parameters/offsetParam'
      - name: orderProperty
        in: query
        schema:
          type: string
          enum:
          - postDate
          - createdAt
          - engagements
          - estimatedImpressions
      - $ref: '#/components/parameters/orderDirection'
      - $ref: '#/components/parameters/approvalStatus'
      - $ref: '#/components/parameters/postsWithUGC'
      - $ref: '#/components/parameters/networkParam'
      - $ref: '#/components/parameters/userFilter'
      - name: networks
        in: query
        description: Array of networks
        schema:
          type: array
          items:
            type: string
      - name: postDateAfter
        in: query
        description: The activation post date is >= this date
        schema:
          type: string
      - name: postDateBefore
        in: query
        description: The activation post date is <= this date
        schema:
          type: string
      - name: actionGroupId
        in: query
        description: Array of action group ids
        schema:
          type: array
          items:
            type: number
      - name: showcaseMode
        in: query
        description: It's showcase time!
        schema:
          type: boolean
      - name: globalUserId
        in: query
        description: The global user Id to filter the results by.
        schema:
          type: integer
      - name: filterTagIds
        in: query
        description: Array of tag ids used For searching activations
        schema:
          type: array
          items:
            type: number
      - name: tagQuantifier
        in: query
        description: any or all option when searching for filterTagIds
        schema:
          type: string
      - name: shouldExportFilenames
        in: query
        description: Whether or not to export the filenames of the activations
        schema:
          type: boolean
      responses:
        '200':
          description: An array of activations.
          content:
            application/json:
              schema:
                properties:
                  meta:
                    $ref: '#/components/schemas/ResponseMetadata'
                  data:
                    items:
                      $ref: '#/components/schemas/ActivationDeprecated'
                    type: array
        '400':
          description: Invalid/missing parameter
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Session expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Invalid API Key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
    post:
      tags:
      - Activations
      operationId: createActivation
      x-access:
      - administrator
      x-handler: activations/activation_controller.js
      summary: Create an activation manually.
      responses:
        '200':
          description: Activation created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActivationDeprecated'
        '400':
          description: Invalid/missing parameter
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Session expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Invalid API Key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Member or action not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - globalUserId
              - actionId
              - instagramPostId
              properties:
                globalUserId:
                  type: integer
                actionId:
                  type: string
                instagramPostId:
                  type: string
                activation:
                  $ref: '#/components/schemas/ActivationDeprecated'
        required: true
    delete:
      tags:
      - Activations
      operationId: deleteAndExcludeActivation
      x-access:
      - administrator
      x-handler: activations/activation_controller.js
      summary: Delete this activation and exclude its content from being re-added to the action group
      parameters:
      - name: activationId
        in: query
        required: true
        schema:
          type: integer
      - name: markIncomplete
        in: query
        schema:
          type: boolean
      - name: trackingStatusId
        in: query
        schema:
          type: integer
      responses:
        '200':
          description: Activation deleted successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EmptyObject'
        '400':
          description: Invalid/missing parameter
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Session expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Invalid API Key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Activation not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /activations/{id}/:
    put:
      tags:
      - Activations
      operationId: updateActivation
      x-handler: activations/activation_controller.js
      x-access:
      - administrator
      summary: Edit an activation.
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/Activation'
      responses:
        '200':
          description: Activation edited successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActivationDeprecated'
        '400':
          description: Invalid parameter.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Session expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Access forbidden.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Message not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /action-groups/{actionGroupId}/self-reported-activation-notifications:
    post:
      tags:
      - Activations
      operationId: selfReportActivationNotification
      x-handler: activations/self_reported_activations/self_reported_activation_notification_controller.js
      x-access:
      - influencer
      summary: "\n          Report information about an activation or content that could not be\n          programmatically activated directly to the marketer"
      parameters:
      - name: actionGroupId
        in: path
        required: true
        schema:
          type: integer
      responses:
        '200':
          description: Activation notification reported successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EmptyObject'
        '400':
          description: Invalid parameter.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Session expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Access forbidden.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                activationId:
                  type: integer
                comment:
                  type: string
  /actions/{actionId}/manual-activations/{globalUserId}:
    post:
      tags:
      - Activations
      operationId: createManualActivation
      x-handler: activations/activation_manual_activate_controller.js
      x-access:
      - administrator
      summary: Create manual activation for action.
      parameters:
      - name: actionId
        in: path
        required: true
        schema:
          type: string
      - name: globalUserId
        in: path
        required: true
        schema:
          type: integer
      - $ref: '#/components/parameters/Activation'
      responses:
        '200':
          description: Activation created successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActivationDeprecated'
        '400':
          description: Invalid parameter.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Session expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Access forbidden.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Message not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /v1/actions/{actionId}/self-reported-activations:
    post:
      operationId: selfReportActivation
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActivationResponse'
        '400':
          description: Validation Failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestError'
        '403':
          description: Access forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenError'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
        '500':
          description: Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServerError'
      tags:
      - Activations
      parameters:
      - in: path
        name: actionId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LegacySelfReportedActivationBody'
  /v1/activations/{activationId}/approveApprovalStatus:
    put:
      operationId: approveApprovalStatus
      responses:
        '200':
          description: Activation successfully approved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TSOAEmptyObject'
        '400':
          description: Cannot Approve an Activation that's already Rejected, set to pending first.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidateErrorJSON'
        '403':
          description: Access forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenError'
        '404':
          description: Activation not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
        '500':
          description: Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServerError'
      tags:
      - Activations
      parameters:
      - in: path
        name: activationId
        required: true
        schema:
          type: number
          format: double
  /v1/activations/{activationId}/unrejectApprovalStatus:
    put:
      operationId: unrejectApprovalStatus
      responses:
        '200':
          description: Activation successfully set back to pending.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TSOAEmptyObject'
        '400':
          description: Cannot 'Unapprove' an Activation that's already approved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidateErrorJSON'
        '403':
          description: Access forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenError'
        '404':
          description: Activation not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
        '500':
          description: Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServerError'
      tags:
      - Activations
      parameters:
      - in: path
        name: activationId
        required: true
        schema:
          type: number
          format: double
  /v1/activations/{activationId}/rejectApprovalStatus:
    put:
      operationId: rejectApprovalStatus
      responses:
        '200':
          description: Activation successfully rejected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TSOAEmptyObject'
        '400':
          description: Cannot reject an Activation that is approved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidateErrorJSON'
        '403':
          description: Access forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenError'
        '404':
          description: Activation not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
        '500':
          description: Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServerError'
      tags:
      - Activations
      parameters:
      - in: path
        name: activationId
        required: true
        schema:
          type: number
          format: double
  /v1/activation/history:
    get:
      operationId: getActivationHistory
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseBody_ActivationHistoryItem-Array_'
        '400':
          description: Invalid Parameter
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidateErrorJSON'
        '403':
          description: Invalid API Key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenError'
        '500':
          description: Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServerError'
      tags:
      - Activations
      parameters:
      - in: query
        name: limit
        required: false
        schema:
          type: number
          format: double
      - in: query
        name: offset
        required: false
        schema:
          type: number
          format: double
      - in: query
        name: campaignId
        required: false
        schema:
          type: string
      - in: query
        name: actionId
        required: false
        schema:
          type: string
      - in: query
        name: audienceId
        required: false
        schema:
          type: string
      - in: query
        name: actionTitle
        required: false
        schema:
          type: string
      - in: query
        name: actionTypes
        required: false
        schema:
          type: string
      - in: query
        name: type
        required: false
        schema:
          type: string
          enum:
          - create
          - amplify
          - survey
          - review
          - follow
          - view
          - other
components:
  schemas:
    ActionGroup:
      properties:
        actions:
          items:
            $ref: '#/components/schemas/Action'
          type: array
        activatedUsersMetrics:
          type: number
          format: double
        activityBudget:
          type: number
          format: double
        application:
          properties:
            requestBrandedContentPermission:
              type: boolean
          type: object
        audience:
          $ref: '#/components/schemas/Audience'
        autoAcceptApplicant:
          type: boolean
        brief:
          type: string
        campaign:
          $ref: '#/components/schemas/Campaign'
        clicksMetrics:
          type: number
          format: double
        community:
          properties:
            instagramHandle:
              type: string
          type: object
        communityId:
          type: string
        contentDueDate:
          type: string
        contentType:
          type: string
        conversionsCountMetrics:
          type: number
          format: double
        conversionsValueMetrics:
          type: number
          format: double
        cost:
          type: number
          format: double
        cpa:
          type: number
          format: double
        cpe:
          type: number
          format: double
        cpeGoal:
          type: number
          format: double
        cpm:
          type: number
          format: double
        cpmGoal:
          type: number
          format: double
        cpp:
          type: number
          format: double
        committedAmount:
          type:
          - number
          - 'null'
          format: double
        paidAmount:
          type:
          - number
          - 'null'
          format: double
        readyAmount:
          type:
          - number
          - 'null'
          format: double
        roiValue:
          type:
          - number
          - 'null'
          format: double
        createdAt:
          type: string
        description:
          type: string
        draftDueDate:
          type: string
        conceptDueDate:
          type: string
        endDate:
          type: string
        engagementRateGoal:
          type: number
          format: double
        engagements:
          type: number
          format: double
        engagementsGoal:
          type: number
          format: double
        engagementsMetrics:
          type: number
          format: double
        ftcHashtag:
          type: string
        fulfilled:
          type: number
          format: double
        globalUserListDefinitionId:
          type: number
          format: double
        hasPointsEnabled:
          type: boolean
        hasScheduledNotifications:
          type: boolean
        hideOnIcm:
          type: boolean
        id:
          type: number
          format: double
        image:
          type: string
        impressions:
          type: number
          format: double
        impressionsGoal:
          type: number
          format: double
        impressionsMetrics:
          type: number
          format: double
        incentive:
          $ref: '#/components/schemas/Incentive'
        incentives:
          items:
            $ref: '#/components/schemas/Incentive'
          type: array
        influencerReviewDeliverable:
          properties:
            listId:
              type: number
              format: double
            count:
              type: number
              format: double
            id:
              type: number
              format: double
          type: object
        internalDescription:
          type: string
        isAutoCreated:
          type: boolean
        isLaterCreatorExperienceEnabled:
          type: boolean
        isPrimaryReferralActivity:
          type: boolean
        listId:
          type: number
          format: double
        listDeliverables:
          items:
            $ref: '#/components/schemas/ListDeliverable'
          type: array
        locale:
          type: string
        mainType:
          type: string
        multipleActivations:
          type: boolean
        name:
          type: string
        notInCommunity:
          type: boolean
        numberOfInfluencers:
          type: number
          format: double
        openGraphTags:
          type: string
        pending:
          type: number
          format: double
        points:
          properties:
            max:
              type: number
              format: double
            min:
              type: number
              format: double
          type: object
        posts:
          type: number
          format: double
        primaryNetwork:
          type: string
        programId:
          type: number
          format: double
        ready:
          type: number
          format: double
        requiredHashtag:
   

# --- truncated at 32 KB (153 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mavrck/refs/heads/main/openapi/mavrck-activations-api-openapi.yml