---
title: "Create a New Bulk Upload of Opportunities"
method: POST
path: "/api/v2/opportunities/bulk"
tags: ["Bulk Upload"]
---

# Create a New Bulk Upload of Opportunities

`POST /api/v2/opportunities/bulk`

This endpoint creates a new bulk upload for opportunities. A maximum of 200 records is allowed. <h3>Required Scope</h3>`opportunity:write`

## Request body

- OpportunitiesBulkBody
  - `data` Apiv2opportunitiesbulkData[]
    - `attributes` Apiv2opportunitiesbulkAttributes
      - `title` string, required — The name of the opportunity.
      - `external-id` string — Your identifier for the Opportunity. The identifier must be unique.
      - `department` string — The department, business unit, or function the Opportunity falls under.
      - `description` string, required — Additional details about the Opportunity to help candidates know if they are a good fit for the Opportunity.
      - `status` string, required — The status of the Opportunity. Possible values include Open and Closed.
      - `visibility` string, required — The visibility setting for the Opportunity. Can only be Private or Organization.
      - `location` string — The geographic location for the Opportunity.
      - `category` string, required — The category for the opportunity. For example, `FullTime`, `Temp`, etc. Category is dependent on your organization's settings, but may include the following: DynamicTeam Assignment, Mentorship, Other, Project, Shadowing, StretchAssignment, LookingForMentor, LookingForMentee, ReverseMentoring, PeerMentoring, Volunteer, or Pro Bono.
      - `duration` integer, required — The duration of the Opportunity.
      - `job-role` string — Must correspond to the name of a plan in order to be valid. The `name` attribute of the GET /skill-plans endpoint resource with `plan-type: Role` can be used.
      - `url` string — URL location where more information can be found.
      - `duration-units` string, required — Must be one of the following: `EndDate`, `Years`, `Months`, `Weeks`, `Days`, `Hours`, `Seconds`, or `Unknown`.
      - `start-date` string, date-time, required — The start date of the opportunity.
      - `end-date` string, date-time, required — The end date of the opportunity.
      - `matched-skills` Apiv2opportunitiesbulkAttributesMatchedskills[] — The skills that match this opportunity.
        - `skill-id` string — The ID of the skill.

## Response `201`

Success

---

[API](https://skmtc.net/degreed/apis/degreed-api-web.md) · [All operations](https://skmtc.net/degreed/apis/degreed-api-web/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/degreed/degreed-api-web/revisions/4a22b709515c/schema)