{ "opencollection": "1.0.0", "info": { "name": "FirstPromoter API", "version": "1.0" }, "request": { "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "items": [ { "info": { "name": "Promoters", "type": "folder" }, "items": [ { "info": { "name": "Get available promoters", "type": "http" }, "http": { "method": "GET", "url": "https://api.firstpromoter.com/api/v2/company/promoters", "headers": [ { "name": "Account-ID", "value": "" } ], "params": [ { "name": "q", "value": "", "type": "query", "description": "Search params for promoters, search using, email, name or ref_id" }, { "name": "ids[]", "value": "", "type": "query", "description": "Array of promoter ids to get" }, { "name": "filters", "value": "", "type": "query", "description": "Filter params" }, { "name": "sorting", "value": "", "type": "query", "description": "Sorting params" } ] }, "docs": "With this endpoint you can list all promoters. \n **HTTP Request**
`GET https://api.firstpromoter.com/api/v2/company/promoters`
" }, { "info": { "name": "Create promoter", "type": "http" }, "http": { "method": "POST", "url": "https://api.firstpromoter.com/api/v2/company/promoters", "headers": [ { "name": "Account-ID", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "With this endpoint you can create a promoter. \n **HTTP Request**
`POST https://api.firstpromoter.com/api/v2/company/promoters`
" }, { "info": { "name": "Get promoter details", "type": "http" }, "http": { "method": "GET", "url": "https://api.firstpromoter.com/api/v2/company/promoters/:id", "headers": [ { "name": "Account-ID", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path", "description": "The promoter's numeric ID, or the value of the attribute specified in `find_by` (e.g. an email address, auth token, ref token, promo code, or cust_id)" }, { "name": "find_by", "value": "", "type": "query", "description": "Find by attribute" } ] }, "docs": "With this endpoint you can get the details of a promoter. \n **HTTP Request**
`GET https://api.firstpromoter.com/api/v2/company/promoters/{id}`
" }, { "info": { "name": "Update promoter", "type": "http" }, "http": { "method": "PUT", "url": "https://api.firstpromoter.com/api/v2/company/promoters/:id", "headers": [ { "name": "Account-ID", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path", "description": "Id of the promoter" } ], "body": { "type": "json", "data": "{}" } }, "docs": "With this endpoint you can update a promoter. \n **HTTP Request**
`PUT https://api.firstpromoter.com/api/v2/company/promoters/{id}`
" }, { "info": { "name": "Get data used for chart", "type": "http" }, "http": { "method": "GET", "url": "https://api.firstpromoter.com/api/v2/company/promoters/:id/chart_data", "headers": [ { "name": "Account-ID", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path", "description": "Id of the promoter" }, { "name": "period_from", "value": "", "type": "query", "description": "From date of the period for the chart, ISO date format (YYYY-MM-DD)" }, { "name": "period_to", "value": "", "type": "query" }, { "name": "selection", "value": "", "type": "query" } ] }, "docs": "With this endpoint you can get the data used for charts.**HTTP Request**
`GET https://api.firstpromoter.com/api/v2/company/promoters/{id}/chart_data`
" }, { "info": { "name": "Accept promoters", "type": "http" }, "http": { "method": "POST", "url": "https://api.firstpromoter.com/api/v2/company/promoters/accept", "headers": [ { "name": "Account-ID", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "With this endpoint you can accept promoters. \n If there are more than __5__ ids on the __ids__ param/field, the action will be processed asynchronously. The response for the batch status will most likely be `in_progress`. The available statuses are `pending`, `in_progress`, `completed`, `failed` and `stopped` \n **HTTP Request**
`POST https://api.firstpromoter.com/api/v2/company/promoters/accept`
" }, { "info": { "name": "Reject promoters", "type": "http" }, "http": { "method": "POST", "url": "https://api.firstpromoter.com/api/v2/company/promoters/reject", "headers": [ { "name": "Account-ID", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "With this endpoint you can reject promoters. \n If there are more than __5__ ids on the __ids__ param/field, the action will be processed asynchronously. The response for the batch status will most likely be `in_progress`. The available statuses are `pending`, `in_progress`, `completed`, `failed` and `stopped` \n **HTTP Request**
`POST https://api.firstpromoter.com/api/v2/company/promoters/reject`
" }, { "info": { "name": "Block promoters", "type": "http" }, "http": { "method": "POST", "url": "https://api.firstpromoter.com/api/v2/company/promoters/block", "headers": [ { "name": "Account-ID", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "With this endpoint you can block promoters. \n If there are more than __5__ ids on the __ids__ param/field, the action will be processed asynchronously. The response for the batch status will most likely be `in_progress`. The available statuses are `pending`, `in_progress`, `completed`, `failed` and `stopped` \n **HTTP Request**
`POST https://api.firstpromoter.com/api/v2/company/promoters/block`
" }, { "info": { "name": "Archive promoters", "type": "http" }, "http": { "method": "POST", "url": "https://api.firstpromoter.com/api/v2/company/promoters/archive", "headers": [ { "name": "Account-ID", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "With this endpoint you can archive promoters. \n If there are more than __5__ ids on the __ids__ param/field, the action will be processed asynchronously. The response for the batch status will most likely be `in_progress`. The available statuses are `pending`, `in_progress`, `completed`, `failed` and `stopped` \n **HTTP Request**
`POST https://api.firstpromoter.com/api/v2/company/promoters/archive`
" }, { "info": { "name": "Move promoters to campaign", "type": "http" }, "http": { "method": "POST", "url": "https://api.firstpromoter.com/api/v2/company/promoters/move_to_campaign", "headers": [ { "name": "Account-ID", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "With this endpoint you can move promoters from one campaign to another. \n If there are more than __5__ ids on the __ids__ param/field, the action will be processed asynchronously. The response for the batch status will most likely be `in_progress`. The available statuses are `pending`, `in_progress`, `completed`, `failed` and `stopped` \n **HTTP Request**
`POST https://api.firstpromoter.com/api/v2/company/promoters/move_to_campaign`
" }, { "info": { "name": "Add promoters to campaign", "type": "http" }, "http": { "method": "POST", "url": "https://api.firstpromoter.com/api/v2/company/promoters/add_to_campaign", "headers": [ { "name": "Account-ID", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "With this endpoint you can add promoters to a campaign. \n If there are more than __5__ ids on the __ids__ param/field, the action will be processed asynchronously. The response for the batch status will most likely be `in_progress`. The available statuses are `pending`, `in_progress`, `completed`, `failed` and `stopped` \n **HTTP Request**
`POST https://api.firstpromoter.com/api/v2/company/promoters/add_to_campaign`
" }, { "info": { "name": "Assign a parent promoter", "type": "http" }, "http": { "method": "POST", "url": "https://api.firstpromoter.com/api/v2/company/promoters/assign_parent", "headers": [ { "name": "Account-ID", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "With this endpoint you can assign a parent promoter to your promoters. \n If there are more than __5__ ids on the __ids__ param/field, the action will be processed asynchronously. The response for the batch status will most likely be `in_progress`. The available statuses are `pending`, `in_progress`, `completed`, `failed` and `stopped` \n **HTTP Request**
`POST https://api.firstpromoter.com/api/v2/company/promoters/assign_parent`
" }, { "info": { "name": "Restore promoters", "type": "http" }, "http": { "method": "POST", "url": "https://api.firstpromoter.com/api/v2/company/promoters/restore", "headers": [ { "name": "Account-ID", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "With this endpoint you can restore promoters. \n If there are more than __5__ ids on the __ids__ param/field, the action will be processed asynchronously. The response for the batch status will most likely be `in_progress`. The available statuses are `pending`, `in_progress`, `completed`, `failed` and `stopped` \n **HTTP Request**
`POST https://api.firstpromoter.com/api/v2/company/promoters/restore`
" } ] } ], "bundled": true }