---
title: "Create capital outcomes engagement handoffs"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.sureshake.com/llms.txt
> Use this file to discover all available pages before exploring further.

Path: Sureshake API › startups

`POST /v2/startups/{startupListingId}/engagement-requests/{engagementRequestId}/capital-outcomes-handoff`

## Path parameters

- `startupListingId` (`capital-outcomes-engagement-handoffs-create.path.startupListingId`; string, required)
  - format `uuid`
- `engagementRequestId` (`capital-outcomes-engagement-handoffs-create.path.engagementRequestId`; string, required)
  - format `uuid`

## Request body

_Required._

- `idempotencyKey` (`capital-outcomes-engagement-handoffs-create.idempotencyKey`; string, required)
  - format `uuid`

## Example request

```json
{
  "idempotencyKey": "0c14c6a6-6f50-4d1e-b0c4-b46ff43ba6a1"
}
```

## Code samples

### cURL

```bash
curl --request POST \
  --url 'https://api.sureshake.com/v2/startups/<startupListingId>/engagement-requests/<engagementRequestId>/capital-outcomes-handoff' \
  --header 'Content-Type: application/json' \
  --data '
{
  "idempotencyKey": "0c14c6a6-6f50-4d1e-b0c4-b46ff43ba6a1"
}
'
```

### TypeScript

```typescript
const url = 'https://api.sureshake.com/v2/startups/<startupListingId>/engagement-requests/<engagementRequestId>/capital-outcomes-handoff';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({idempotencyKey: '0c14c6a6-6f50-4d1e-b0c4-b46ff43ba6a1'})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));
```

### Python

```python
import requests

url = "https://api.sureshake.com/v2/startups/<startupListingId>/engagement-requests/<engagementRequestId>/capital-outcomes-handoff"

payload = { "idempotencyKey": "0c14c6a6-6f50-4d1e-b0c4-b46ff43ba6a1" }
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
```

## Responses

### 201

Default Response

#### Example

```json
{
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "startupListingId": "d16a646b-f433-44ce-aaae-42761cf79f25",
    "startupEntityId": "e54dea79-aa5c-4e2a-93df-a0dcd373cd04",
    "relationshipId": "928dd5b8-3ead-4528-bdef-9c0b867a5d7d",
    "classification": {
      "stage": "meeting",
      "eventType": "investor.meeting_requested",
      "category": "qualified_engagement",
      "qualifiedAction": true,
      "countsAsCapitalAccessOutcome": false,
      "evidenceKind": "explicit_engagement_record",
      "definitionVersion": "marketplace-capital-engagement/v1"
    },
    "source": {
      "recordType": "startup_engagement_request",
      "recordId": "0470cfd4-dcf3-4d8c-ac28-58c6deeff25f",
      "activityEventId": "265b14df-2489-447a-bd2e-4ca441f47b54",
      "occurredAt": "2019-08-24T14:15:22Z",
      "actorUserId": "string",
      "principal": {
        "type": "entity",
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      }
    },
    "handoff": {
      "status": "accepted",
      "handedOffByUserId": "string",
      "handedOffAt": "2019-08-24T14:15:22Z"
    }
  },
  "meta": {
    "timestamp": "2019-08-24T14:15:22Z"
  }
}
```

- `data` (`capital-outcomes-engagement-handoffs-create.response.201.data`; object, required)
  - `id` (`capital-outcomes-engagement-handoffs-create.response.201.data.id`; string, required)
    - format `uuid`
  - `startupListingId` (`capital-outcomes-engagement-handoffs-create.response.201.data.startupListingId`; string, required)
    - format `uuid`
  - `startupEntityId` (`capital-outcomes-engagement-handoffs-create.response.201.data.startupEntityId`; string, required)
    - format `uuid`
  - `relationshipId` (`capital-outcomes-engagement-handoffs-create.response.201.data.relationshipId`; string, required)
    - format `uuid`
  - `classification` (`capital-outcomes-engagement-handoffs-create.response.201.data.classification`; object, required)
    - `stage` (`capital-outcomes-engagement-handoffs-create.response.201.data.classification.stage`; string, required)
      - one of `"meeting"`, `"diligence"`
    - `eventType` (`capital-outcomes-engagement-handoffs-create.response.201.data.classification.eventType`; string, required)
      - one of `"investor.meeting_requested"`, `"investor.report_requested"`, `"investor.diligence_requested"`
    - `category` (`capital-outcomes-engagement-handoffs-create.response.201.data.classification.category`; string, required)
      - one of `"qualified_engagement"`
    - `qualifiedAction` (`capital-outcomes-engagement-handoffs-create.response.201.data.classification.qualifiedAction`; boolean, required)
      - one of `true`
    - `countsAsCapitalAccessOutcome` (`capital-outcomes-engagement-handoffs-create.response.201.data.classification.countsAsCapitalAccessOutcome`; boolean, required)
      - one of `false`
    - `evidenceKind` (`capital-outcomes-engagement-handoffs-create.response.201.data.classification.evidenceKind`; string, required)
      - one of `"explicit_engagement_record"`
    - `definitionVersion` (`capital-outcomes-engagement-handoffs-create.response.201.data.classification.definitionVersion`; string, required)
      - one of `"marketplace-capital-engagement/v1"`
  - `source` (`capital-outcomes-engagement-handoffs-create.response.201.data.source`; object, required)
    - `recordType` (`capital-outcomes-engagement-handoffs-create.response.201.data.source.recordType`; string, required)
      - one of `"startup_engagement_request"`
    - `recordId` (`capital-outcomes-engagement-handoffs-create.response.201.data.source.recordId`; string, required)
      - format `uuid`
    - `activityEventId` (`capital-outcomes-engagement-handoffs-create.response.201.data.source.activityEventId`; string, required)
      - format `uuid`
    - `occurredAt` (`capital-outcomes-engagement-handoffs-create.response.201.data.source.occurredAt`; string, required)
      - format `date-time`
    - `actorUserId` (`capital-outcomes-engagement-handoffs-create.response.201.data.source.actorUserId`; string, required)
      - minLength 1
    - `principal` (`capital-outcomes-engagement-handoffs-create.response.201.data.source.principal`; object, required)
      - `type` (`capital-outcomes-engagement-handoffs-create.response.201.data.source.principal.type`; string, required)
        - one of `"entity"`
      - `id` (`capital-outcomes-engagement-handoffs-create.response.201.data.source.principal.id`; string, required)
        - format `uuid`
  - `handoff` (`capital-outcomes-engagement-handoffs-create.response.201.data.handoff`; object, required)
    - `status` (`capital-outcomes-engagement-handoffs-create.response.201.data.handoff.status`; string, required)
      - one of `"accepted"`
    - `handedOffByUserId` (`capital-outcomes-engagement-handoffs-create.response.201.data.handoff.handedOffByUserId`; string, required)
      - minLength 1
    - `handedOffAt` (`capital-outcomes-engagement-handoffs-create.response.201.data.handoff.handedOffAt`; string, required)
      - format `date-time`
- `meta` (`capital-outcomes-engagement-handoffs-create.response.201.meta`; object, optional)
  - `timestamp` (`capital-outcomes-engagement-handoffs-create.response.201.meta.timestamp`; string, required)
    - format `date-time`

### 400

Default Response

#### Example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}
```

- `error` (`capital-outcomes-engagement-handoffs-create.response.400.error`; object, required)
  - `code` (`capital-outcomes-engagement-handoffs-create.response.400.error.code`; string, required) — Machine-readable error code (e.g., NOT_FOUND)
  - `message` (`capital-outcomes-engagement-handoffs-create.response.400.error.message`; string, required) — Human-readable error message
  - `details` (`capital-outcomes-engagement-handoffs-create.response.400.error.details`; unknown, optional) — Optional structured error details
  - `traceId` (`capital-outcomes-engagement-handoffs-create.response.400.error.traceId`; string, optional) — Unique ID for log correlation

### 401

Default Response

#### Example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}
```

- `error` (`capital-outcomes-engagement-handoffs-create.response.401.error`; object, required)
  - `code` (`capital-outcomes-engagement-handoffs-create.response.401.error.code`; string, required) — Machine-readable error code (e.g., NOT_FOUND)
  - `message` (`capital-outcomes-engagement-handoffs-create.response.401.error.message`; string, required) — Human-readable error message
  - `details` (`capital-outcomes-engagement-handoffs-create.response.401.error.details`; unknown, optional) — Optional structured error details
  - `traceId` (`capital-outcomes-engagement-handoffs-create.response.401.error.traceId`; string, optional) — Unique ID for log correlation

### 403

Default Response

#### Example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}
```

- `error` (`capital-outcomes-engagement-handoffs-create.response.403.error`; object, required)
  - `code` (`capital-outcomes-engagement-handoffs-create.response.403.error.code`; string, required) — Machine-readable error code (e.g., NOT_FOUND)
  - `message` (`capital-outcomes-engagement-handoffs-create.response.403.error.message`; string, required) — Human-readable error message
  - `details` (`capital-outcomes-engagement-handoffs-create.response.403.error.details`; unknown, optional) — Optional structured error details
  - `traceId` (`capital-outcomes-engagement-handoffs-create.response.403.error.traceId`; string, optional) — Unique ID for log correlation

### 404

Default Response

#### Example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}
```

- `error` (`capital-outcomes-engagement-handoffs-create.response.404.error`; object, required)
  - `code` (`capital-outcomes-engagement-handoffs-create.response.404.error.code`; string, required) — Machine-readable error code (e.g., NOT_FOUND)
  - `message` (`capital-outcomes-engagement-handoffs-create.response.404.error.message`; string, required) — Human-readable error message
  - `details` (`capital-outcomes-engagement-handoffs-create.response.404.error.details`; unknown, optional) — Optional structured error details
  - `traceId` (`capital-outcomes-engagement-handoffs-create.response.404.error.traceId`; string, optional) — Unique ID for log correlation

### 409

Default Response

#### Example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}
```

- `error` (`capital-outcomes-engagement-handoffs-create.response.409.error`; object, required)
  - `code` (`capital-outcomes-engagement-handoffs-create.response.409.error.code`; string, required) — Machine-readable error code (e.g., NOT_FOUND)
  - `message` (`capital-outcomes-engagement-handoffs-create.response.409.error.message`; string, required) — Human-readable error message
  - `details` (`capital-outcomes-engagement-handoffs-create.response.409.error.details`; unknown, optional) — Optional structured error details
  - `traceId` (`capital-outcomes-engagement-handoffs-create.response.409.error.traceId`; string, optional) — Unique ID for log correlation

### 500

Default Response

#### Example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}
```

- `error` (`capital-outcomes-engagement-handoffs-create.response.500.error`; object, required)
  - `code` (`capital-outcomes-engagement-handoffs-create.response.500.error.code`; string, required) — Machine-readable error code (e.g., NOT_FOUND)
  - `message` (`capital-outcomes-engagement-handoffs-create.response.500.error.message`; string, required) — Human-readable error message
  - `details` (`capital-outcomes-engagement-handoffs-create.response.500.error.details`; unknown, optional) — Optional structured error details
  - `traceId` (`capital-outcomes-engagement-handoffs-create.response.500.error.traceId`; string, optional) — Unique ID for log correlation


Source: https://docs.sureshake.com/reference/capital-outcomes-engagement-handoffs-create/index.md