Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1445428373.9 KB

This action creates an opportunity from an existing engagement context. The task is asynchronous and orchestrates the process of converting engagement contextual information into a structured opportunity record within the partner's account.

post/#X-Amz-Target=AWSPartnerCentralSelling.StartOpportunityFromEngagementTask

Headers

X-Amz-Target'AWSPartnerCentralSelling.StartOpportunityFromEngagementTask' required

Request body

Catalogstring required

Specifies the catalog in which the opportunity creation task is executed. Acceptable values include <code>AWS</code> for production and <code>Sandbox</code> for testing environments.

ClientTokenstring required

A unique token provided by the client to help ensure the idempotency of the request. It helps prevent the same task from being performed multiple times.

Identifierstring required

The unique identifier of the engagement from which the opportunity creation task is to be initiated. This helps ensure that the task is applied to the correct engagement.

ContextIdentifierstring required

The unique identifier of the engagement context from which to create the opportunity. This specifies the specific contextual information within the engagement that will be used for opportunity creation.

Response

Success

TaskIdstring

The unique identifier of the task, used to track the task's progress.

TaskArnstring

The Amazon Resource Name (ARN) of the task, used for tracking and managing the task within AWS.

StartTimestring date-time

The timestamp indicating when the task was initiated. The format follows RFC 3339 section 5.6.

TaskStatus'IN_PROGRESS' | 'COMPLETE' | 'FAILED'

Indicates the current status of the task.

Messagestring

If the task fails, this field contains a detailed message describing the failure and possible recovery steps.

ReasonCode'InvitationAccessDenied' | 'InvitationValidationFailed' | 'EngagementAccessDenied' | 'OpportunityAccessDenied' | 'ResourceSnapshotJobAccessDenied' | 'ResourceSnapshotJobValidationFailed' | 'ResourceSnapshotJobConflict' | 'EngagementValidationFailed' | 'EngagementConflict' | 'OpportunitySubmissionFailed' | 'EngagementInvitationConflict' | 'InternalError' | 'OpportunityValidationFailed' | 'OpportunityConflict' | 'ResourceSnapshotAccessDenied' | 'ResourceSnapshotValidationFailed' | 'ResourceSnapshotConflict' | 'ServiceQuotaExceeded' | 'RequestThrottled' | 'ContextNotFound' | 'CustomerProjectContextNotPermitted' | 'DisqualifiedLeadNotPermitted'

Indicates the reason for task failure using an enumerated code.

OpportunityIdstring

The unique identifier of the opportunity created as a result of the task. This field is populated when the task is completed successfully.

ResourceSnapshotJobIdstring

The identifier of the resource snapshot job created as part of the opportunity creation process.

EngagementIdstring

The unique identifier of the engagement from which the opportunity was created.

ContextIdstring

The unique identifier of the engagement context used to create the opportunity.