How-toOracle Fusion Cloud Project ManagementProject Management / REST API

Project Creation API in Oracle Fusion

Question
project creation api in oracle fusion

Also searched as

  • oracle fusion create project rest api
  • project api in oracle fusion
  • oracle fusion projects POST payload
  • create project from template fusion rest

Short answer

Oracle Fusion Cloud creates projects through the Project Management REST API: a POST to the projects resource under /fscmRestApi/resources/ with a JSON body naming the project, number, organization, legal entity, project unit and usually a source template. Tasks, team members and classifications are then added through child resources of the new project.

Applies to: Oracle Fusion Cloud Project Management (Project Financial Management), REST API version path as published for your release, such as 11.13.18.05

How to create a project with the Fusion REST API

  1. 1Create an integration user and give it a job role that carries project creation privileges, such as Project Application Administrator or a custom role copied from Project Manager. Without it you get 403 or an empty list.
  2. 2Identify the setup values you must send by name or ID: project unit, organization, legal entity and the source project template. Look them up with GET calls on the matching REST resources or in Setup and Maintenance.
  3. 3Open the REST API for Oracle Fusion Cloud Project Management guide for your release and confirm the exact attribute names of the projects resource, because they differ slightly between releases.
  4. 4POST to /fscmRestApi/resources/<version>/projects with Content-Type application/json and basic or OAuth/JWT authentication.
  5. 5Read the response: it returns the generated ProjectId and the created project record. Store ProjectId for follow-up calls.
  6. 6Add tasks with POST to /projects/{ProjectId}/child/Task, and team members with the ProjectTeamMember child resource, if the template does not already supply them.
  7. 7Verify in the UI under Project Management > Project Financial Management > Manage Project, then check the project status and that the project unit security lets the intended users see it.

A minimal request

A typical request creates the project from a template so that tasks, classifications, burden schedules and the project type are inherited instead of repeated in the payload. The attribute names below follow the project resource as commonly documented; treat them as a starting point and validate against the describe endpoint of your own pod.

Use the describe call (append /describe to the resource URL) to see every attribute, which are required, and which child resources exist. That is faster and more reliable than any blog post, including this one, because Oracle adds attributes each quarterly update.

POST https://<pod>.fa.<region>.oraclecloud.com/fscmRestApi/resources/11.13.18.05/projects
Content-Type: application/json

{
  "ProjectName": "Line 4 Retrofit",
  "ProjectNumber": "PRJ-2026-0412",
  "SourceTemplateNumber": "CAPEX_STD",
  "OrganizationName": "Plant 2 Operations",
  "LegalEntityName": "Example Manufacturing Inc",
  "ProjectUnitName": "North America Projects",
  "StartDate": "2026-11-01",
  "FinishDate": "2027-03-31",
  "Description": "Retrofit of assembly line 4"
}
GET .../fscmRestApi/resources/11.13.18.05/projects/describe

Templates, tasks and child resources

Creating a project without a template means you must also send the project type-driven defaults yourself, and most integrations fail on missing required fields because of that. Keep a small set of templates per project type and let the API pick one by number.

Child resources such as Task, ProjectTeamMember and ProjectClassification are written either inline in a deep-insert payload or with separate POSTs. Separate POSTs are easier to retry and debug when one task fails validation. For bulk loads of hundreds of projects, the File-Based Data Import for projects is usually faster than one REST call per record.

Errors you will meet

A 400 with a message that a value is invalid almost always means a name did not resolve: the organization is not a project-owning organization, the legal entity is not assigned to the project unit, or the template is not active for that unit. A 401 means the credentials or token are wrong, a 403 means the role lacks the privilege or the data security scope.

A duplicate project number returns a validation error. If your numbering is automatic in setup, omit ProjectNumber and read it back from the response instead of generating your own.

Try it here, free

Oracle Fusion REST API URL Builder

Open full tool

Fill in host, version and resource to generate a Fusion Cloud REST URL with query parameters and a ready curl command.

Common pitfalls

  • !Copying attribute names from an older release and getting silent ignores or 400 errors. Always check the /describe output for your pod.
  • !Using a personal user for the integration. Password resets and role changes will break the job. Use a dedicated service user.
  • !Sending organization or template display names that differ by a trailing space or case from setup.
  • !Skipping the project unit, which controls who can see and edit the project through data security.
  • !Creating thousands of projects serially through REST instead of using file-based import for bulk migration.

How an ERP-grounded AI assistant handles this

A grounded assistant can read the /describe metadata of your pod, show which attributes are required for your template and generate a correct payload from a plain request such as 'new capex project for line 4'. With a private deployment it does this without sending your project data outside your network, and any POST stays behind human approval.

See ERPray

Frequently asked questions

What is the endpoint to create a project in Oracle Fusion?

It is a POST to the projects resource of the Fusion REST API, under /fscmRestApi/resources/<version>/projects. The version segment depends on your release, so read it from the REST API guide or from your pod's describe endpoint rather than assuming one.

Do I need a template to create a project through the API?

Strictly it depends on setup, but in practice yes. A source template supplies the project type, tasks, burden and other defaults, which keeps the payload small and consistent. Without one you must provide many more attributes.

Can I add tasks in the same call?

Fusion supports deep insert for child resources in many cases, but separate POSTs to the Task child resource are easier to retry and debug. Inheriting tasks from a template avoids the question entirely.

Which role do I need?

A job role with the project creation and management privileges, such as Project Application Administrator or a custom role copied from Project Manager, plus data security access to the project unit and organization.

Related

How-to

Paginate And Authenticate Oracle Fusion REST API Calls Correctly

Oracle Fusion Cloud REST APIs authenticate with HTTP Basic Authentication, an integration user's credentials, over HTTPS by default, and paginate with limit and offset query parameters rather than a page number. Loop on the hasMore flag in the response until it returns false to retrieve a full result set.

How-to

Oracle ERP API Documentation: Where It Is and How to Start

Oracle publishes its ERP APIs per product on docs.oracle.com. For Fusion Cloud ERP and SCM there are REST API guides, SOAP web service guides, FBDI file imports and BI Publisher reports; for NetSuite there are SuiteTalk REST and SOAP, SuiteQL and RESTlets. Pick the product first, then the style of API, then match your authentication and the exact release version.

How-to

Connect Oracle Integration Cloud (OIC) To Fusion ERP

OIC connects to Fusion ERP primarily through the prebuilt ERP Cloud Adapter, which wraps Fusion's REST and SOAP web services with OAuth-based authentication and pick-list discovery of available business objects and operations, instead of you hand-building every REST call. Use the adapter for standard integrations; drop to a generic REST or SOAP adapter only when the ERP Cloud Adapter does not yet expose the specific service you need.

Error fix

Fix The Oracle Fusion "You Don't Have Access To This Data" Error

This generic Oracle Fusion security message means the function privilege and the data security scope did not both line up for that user on that record - most often the job role is assigned but the matching data role, security profile, or business unit and ledger context in Manage Data Access for Users is missing. Fix it by checking data access setup for the user's role, not by re-granting the same job role again.

Error fix

Fix FBDI Import Failures From Interface Table Validation Errors

When a Fusion FBDI import job errors out, the cause is almost always bad data in the interface tables (an invalid value set, a wrong date format, or a missing required column), not the ESS job itself. Open the process's Interface Errors Report or the Correct Import Errors spreadsheet to see the exact rejected rows and reason codes, fix the source data, and resubmit from the interface tables instead of re-running the whole FBDI load.

Error fix

Clear An Oracle Fusion ESS Job Stuck In Blocked Status

A Blocked status on an Oracle Fusion Enterprise Scheduler (ESS) job almost always means an earlier instance of the exact same job is still running or stuck, and the job definition does not allow simultaneous requests. Find and finish, or cancel, the earlier request first; only then does the Blocked request move to Running.

AI for ERP

Fusion Cloud ERP AI: OCI Generative AI Service vs. a Private LLM

How Fusion Cloud ERP AI supports GenAI implementation: OCI Generative AI Service for Fusion-only use cases, a private LLM for sensitive or cross-system data.

AI for ERP

AI for Oracle Cloud SCM and Manufacturing, Grounded in Your Planning Data

Add grounded AI to Oracle Cloud SCM and Fusion Manufacturing: demand plans, work orders, and supplier data, answered on-prem or in a private cloud with full query visibility.

Stuck on Oracle Fusion Cloud Project Management?

Talk to engineers who work inside Oracle Fusion Cloud Project Management every week, and who build private AI that answers these questions from your own ERP data.

Talk to an ERP engineerBrowse ERP Help
All ERP Help articles

Keep exploring

Free tools

ERP fixes and how-tos

Runs with your ERP

AI on your ERP

Integrations

Comparisons

Software