On New Submission

Estimated reading: 6 minutes 472 views

Summary: A breakdown of the data returned to you through the Zealous API when a new submission is drafted and completed.

Request

Returns the data of any new submissions made to a specific opportunity belonging to your account.

This includes all works made as part of this submission, as well as payment information for that one entry.

Parameters

api_key (required)

The API key you have generated on Zealous. Keep it safe, since it gives anyone with it access to your data.

opportunity_id (required)

The ID of the opportunity you wish this webhook to listen to.

entry_id (optional)

The ID of the entry you wish to load.

Response

Returns the Submission object belonging to the opportunity_id.

This includes:

Submission (submission_…)

All information relating to the submission, such as key dates, the title, description, unique ids and more. All data linked to the submission object starts with submission_

Candidate (candidate_…)

Data relating to the candidate making the submissions such as name, address, email, phone number and more. All data linked to the submission object starts with candidate_

Added Works (“works”:[…])

A list of objects added to this submission. This could be an upload, embed or text element. Each object contains it’s own data relating to it. Such as the web address of the upload, the name, id, and dimension’s of it (if applicable in your process). All data linked to works can be found in the “works” : […] list.

Payment Details (“payment”:)

If you take a payment, the “payment:” object will also be provided with details such as amount, currency, tax breakdown etc.

{
  "opportunity_id": "MnXZOY02XXXXXXXXXXXX",

  "submission_created": "2023-10-23T15:49:23+0000",
  "submission_updated": "2023-10-23T15:49:23+0000",
  "submission_published": "2023-10-23T15:49:23+0000",
  "submission_id": "njTvtzHKXXXXXXXXXXXX",
  "submission_short_id": "AA001",
  "submission_status": "Round 1",
  "submission_category ": "Best Director",

  "candidate_id": "fFAuHjrXXXXXXXXXXXXX",	
  "candidate_email": "[email protected]",
  "candidate_firstname": "Jane",
  "candidate_surname": "Kobayashi-Doe",
  "candidate_nickname": "Autumn Myst",
  "candidate_role": "Artist",
  "candidate_address_line1": "652",	
  "candidate_address_line2": "Greystone Court",
  "candidate_address_city": "Fort Washington",
  "candidate_address_postcode": "MD 20744",
  "candidate_address_country": "United States",
  "candidate_phone": "+1 213 621 0002",
  "candidate_url": "https://zealous.co/username/portfolio/",

  "submission_title": "Hello World",
  "submission_description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse fermentum nec urna non ultrices. Phasellus rutrum consectetur porta.",	
  "submission_field": "Art",
  "submission_url": "https://zealous.co/username/entry/opportunity/candidate/entry/...",
  "submission_cover_image": "https://storage/.../cover_image",
  "submission_project_id": "wmWCbvyXXXXXXXXXXXXX",	
  
  "works": [
      {
        "work_id": "1KmGRSXXXXXXXXXXXXXX",
        "work_name": "Title of work 1",
        "work_content_original": "https://storage/.../work_1_media_link",
        "work_content_thumbnail": "https://storage/.../work_1_thumbnail_media_link",
        "work_is_physical": "false",
        "work_size_unit": "cm",
        "work_size_width": "30",
        "work_size_height": "30",
        "work_size_depth": "5",
        "work_weight_unit": "kg",
        "work_weight": "1.5",
        "work_price": "300",
        "work_description": "Description of work 1"
      },
      {
        "work_id": "1KmGRSXXXXXXXXXXXXXX",
        "work_name": "Title of work 2",
        "work_content_original": "https://storage/.../work_2_media_link",
        "work_content_thumbnail": "https://storage/.../work_2_thumbnail_media_link",
        "work_is_physical": "false",
        "work_size_unit": "inches",
        "work_size_width": "12",
        "work_size_height": "2",
        "work_size_depth": "1",
        "work_weight_unit": "pounds",
        "work_weight": "3",
        "work_price": "1200",
        "work_description": "Description of work 2"
      },
      ...
    ],

  "submission_paid": "true",	

  "payment": {
      "id": "he5UxOdXXXXXXXXXXXXX",
      "submissions_allowed": 1,
      "submissions_made": 1,
      "package_id": "NAlt56RXXXXXXXXXXXXX",
      "package_name": "1",
      "currency": "gbp",
      "stripe_fees": "0.63",
      "zealous_fees": "0.49",
      "stripe_transaction_id": "ch_3Nuf5r2a7XXXXXXXXXXXXXXX",
      "status": "succeeded",
      "total_net": "9.88",
      "tax_rate": "vat 20",
      "tax_type": "EXCLUSIVE",
      "tax_value": "2.2",
      "tax_percentage": "20.0",
      "invoice_url": "https://pay.stripe.com/receipts/invoices/...",
      "total_transferred": "12.08",
      "total_gross": "13.2",
      "method": "card"
    }  
  }
}