1. Buyer API
  • Supplier API – FAQ
  • Supplier API
    • Onboarding Process
    • Mapping
    • Survey Inventory Management
    • Respondent-Survey Flow
    • Statuses, Term Reasons & Categories
    • Onboarding Checklist
    • API Call Flow
    • Complete Validation Notifications
    • Frequently Asked Questions (FAQ)
    • Lookup Question Library
      GET
    • Set Global redirect URLs and Pixels for supplier’s
      PUT
    • Delete Global redirect URLs and Pixels for supplier’s account
      DELETE
    • Core Metadata Fields
      GET
    • Get Question Categories
      GET
    • Get Allocated Surveys (all live surveys)
      GET
    • Get Allocated Surveys By Id
      GET
    • Get Allocated Surveys By Date (live surveys only)
      GET
    • Get Allocated Surveys With Pagination (live surveys only)
      GET
    • Get Redirect Method for Survey
      GET
    • Set Redirect Method for Survey
      PUT
    • Delete Redirect Method for Survey
      DELETE
    • Get Closed Survey List (allocated to supplier only)
      GET
    • Get Survey Transactions data
      GET
    • Get Survey Transactions data By Date Range
      GET
    • Survey Allow for Unique IP
      POST
    • Allow Unique PID & IP
      POST
    • Get Panellist Profiling
      GET
    • Survey Availability Endpoint
      GET
    • Get Survey Stats data By Date Range
      GET
    • Get Questions By Category
      GET
    • Answer Lookup
      GET
    • Get Survey Transactions data By PID and survey number
      GET
    • Get PIDs for re-contact surveys (studies)
      GET
    • Get survey stats
      GET
    • Set Panellist Profiling
      POST
    • update Panellist Profiling
      PUT
    • get surveys for respondent
      POST
    • Respondent Pre Survey Check
      POST
    • Single Term Reason Category Code
      GET
    • term reason category
      GET
    • Get Allocated High Priority Surveys(All Live Surveys)
      GET
    • Get Survey Targeting
      GET
    • Get Quota for Survey
      GET
  • Buyer API - FAQ
  • Buyer API
    • Create Job
      POST
    • Update Job
      PUT
    • Get Job Details
      GET
    • Update Job Status
      PUT
    • Get Job List By Status
      POST
    • Create Group
      POST
    • Update Group
      PUT
    • Get Group Details
      GET
    • Update Group Status
      PUT
    • Add Target to group
      POST
    • Update Target to group
      PUT
    • Remove Target Question
      DELETE
    • Add Quota to Group
      POST
    • Update Group Quota
      PUT
    • Get Group Quotas
      GET
    • Get Group Feasibility
      GET
    • Feasibility (Find estimates)
      POST
    • Questions Library
      GET
    • Get Job Stats
      GET
    • Get Group Stats
      GET
    • Get Group Quota Stats
      GET
  • Postbacks/Redirects
    • Redirect URL
    • PostBack URL
    • Hashing Mechanism
  • HTTP Status Codes
  • Text Analyzer API - FAQ
  • Text Analyzer API
    • API Details
  1. Buyer API

Create Job

Production Endpoint
https://apivisionsampling.innovatemr.com/api/v2
Production Endpoint
https://apivisionsampling.innovatemr.com/api/v2
POST
https://apivisionsampling.innovatemr.com/api/v2
/pega/job
This API will allow you to create job.

Request

Header Params
x-access-token
string 
required
YOUR_X-ACCESS-TOKEN_HERE
Content-Type
string 
required
application/json
Body Params application/json
Name
string 
required
SalesRepresentative
integer 
optional
ProjectManager
integer 
optional
ProjectManagerAlt
integer 
optional
ReferenceNumber
string 
optional
Maximum Length can be 100 chars
Status
integer 
required
Example 0/1/2
Description
string 
optional
Category
integer 
required
It can be a Number from 1 to 43
isEncryptionAdded
integer 
optional
Values can be 0 or 1
FingerPrintingLevel
integer 
optional
Values can be 1, 2, 3 or 4(If we pass ‘FingerPrintingLevel’ as 4 then 'selectedJobsId’ Fields will be mandatory)
selectedJobsId
array[integer]
optional
Array of JobIds like [11048, 11049]
AllowDuplicateStatus
array[integer]
optional
Array of Numbers like [1, 2, 3, 4]
StartDate
string 
optional
ISO String format
EndDate
string 
optional
ISO String format
ProjectedCloseDate
object 
optional
Year
integer 
optional
YYYY format
Month
integer 
optional
MM format
DigitalFingerprintType
integer 
optional
Value should be 3
UniqueIPCheck
integer 
optional
Used as boolean 0 for false and 1 for true
UniquePIDCheck
integer 
optional
Used as boolean 0 for false and 1 for true
Example
{
    "Name": "Sample Project",
    "SalesRepresentative": 12345,
    "ProjectManager": 67890,
    "ProjectManagerAlt": 11223,
    "ReferenceNumber": "REF-20250303-001",
    "Status": 1,
    "Description": "This is a sample project description.",
    "Category": 5,
    "isEncryptionAdded": 1,
    "FingerPrintingLevel": 3,
    "selectedJobsId": [
        11048,
        11049
    ],
    "AllowDuplicateStatus": [
        1,
        2,
        3,
        4
    ],
    "StartDate": "2025-03-03T00:00:00.000Z",
    "EndDate": "2025-06-03T00:00:00.000Z",
    "ProjectedCloseDate": {
        "Year": 2025,
        "Month": 6
    },
    "DigitalFingerprintType": 3,
    "UniqueIPCheck": 1,
    "UniquePIDCheck": 0
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://apivisionsampling.innovatemr.com/api/v2/pega/job' \
--header 'x-access-token;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "Name": "Sample Project",
    "SalesRepresentative": 12345,
    "ProjectManager": 67890,
    "ProjectManagerAlt": 11223,
    "ReferenceNumber": "REF-20250303-001",
    "Status": 1,
    "Description": "This is a sample project description.",
    "Category": 5,
    "isEncryptionAdded": 1,
    "FingerPrintingLevel": 3,
    "selectedJobsId": [
        11048,
        11049
    ],
    "AllowDuplicateStatus": [
        1,
        2,
        3,
        4
    ],
    "StartDate": "2025-03-03T00:00:00.000Z",
    "EndDate": "2025-06-03T00:00:00.000Z",
    "ProjectedCloseDate": {
        "Year": 2025,
        "Month": 6
    },
    "DigitalFingerprintType": 3,
    "UniqueIPCheck": 1,
    "UniquePIDCheck": 0
}'

Responses

🟢200OK
application/json
Body
apiStatus
string 
required
msg
string 
required
job
object 
required
Customer
object 
required
ProjectManager
object 
required
ProjectedCloseDate
object 
required
Status
integer 
required
FingerPrintingLevel
integer 
required
AllowDuplicateStatus
array[string]
required
Name
string 
required
Category
integer 
required
isEncryptionAdded
integer 
required
DigitalFingerprintType
integer 
required
CustomerContact
array [object {3}] 
required
StartDate
string 
required
EndDate
string 
required
LiveDate
string 
required
Id
integer 
required
Success
string 
required
Termination
string 
required
Over Quota
string 
required
Quality Termination
string 
required
result
object 
required
status
string 
required
disqualification
string 
required
Example
{
    "apiStatus": "success",
    "msg": "Job is successfully added",
    "job": {
        "Customer": {
            "CustomerName": "customer_demo",
            "CustomerId": 389
        },
        "ProjectManager": {
            "ProjectManagerName": "pm1",
            "ProjectManagerId": 67
        },
        "ProjectedCloseDate": {
            "Month": 1,
            "Year": 2019
        },
        "Status": 1,
        "FingerPrintingLevel": 2,
        "AllowDuplicateStatus": [],
        "Name": "Job for Group Main",
        "Category": 1,
        "isEncryptionAdded": 0,
        "DigitalFingerprintType": 3,
        "CustomerContact": [
            {
                "Primary": 0,
                "CustomerContactId": 671,
                "CustomerContactName": "DemoCustomer"
            }
        ],
        "StartDate": "2019-01-02T11:04:34.662Z",
        "EndDate": "2019-01-02T11:04:34.663Z",
        "LiveDate": "2019-01-02T11:04:34.663Z",
        "Id": 8535,
        "Success": "https://apivisionsampling.innovatemr.com/surveyDone?sc=1&tk=",
        "Termination": "https://apivisionsampling.innovatemr.com/surveyDone?sc=2&tk=",
        "Over Quota": "https://apivisionsampling.innovatemr.com/surveyDone?sc=3&tk=",
        "Quality Termination": "https://apivisionsampling.innovatemr.com/surveyDone?sc=4&tk="
    }
}
Previous
Buyer API
Next
Update Job
Built with