---
title: "How do I create a corporate action source?"
slug: "how-do-i-create-a-corporate-action-source"
tags: ["corporate action source"]
updated: 2024-11-06T16:57:52Z
published: 2024-11-06T16:57:52Z
canonical: "support.lusid.com/how-do-i-create-a-corporate-action-source"
---

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

# How do I create a corporate action source?

Providing you have suitable [access control permissions](/v1/docs/identity-management-and-access-control-iam), you can create a *corporate action source*.

You can then [subscribe one or more transaction portfolios](/v1/docs/handling-a-cash-dividend-corporate-action-event#subscribing-a-portfolio-to-the-corporate-action-source) to the source, and [upload corporate actions](/v1/docs/how-do-i-upload-corporate-actions-to-a-corporate-action-source) to it.

## Using the LUSID API

1. [Obtain an API access token](/v1/docs/how-do-i-obtain-and-use-a-short-lived-api-access-token-from-okta).
2. Call the [CreateCorporateActionSource](https://www.lusid.com/docs/api/#operation/CreateCorporateActionSource) API, specifying:

For example:

```json
curl -X POST 'https://<your-domain>.lusid.com/api/api/corporateactionsources'
  -H 'Content-Type: application/json-patch+json'
  -H 'Authorization: Bearer <your-API-access-token>'
  -d '{
    "scope": "Example-CAS-scope",
    "code": "Example-CAS-code",
    "displayName": "Example corporate action source",
    "description": "This is an example corporate action source",
    "instrumentScopes": ["example-instrument-scope"]
  }'
```
  - A `scope` and `code` that together uniquely identify the source (the latter must be unique within the former).
  - A meaningful `displayName`.
  - A single [instrument scope](/v1/docs/understanding-instrument-scopes) in the `instrumentScopes` field if the transaction portfolio(s) you intend to register resolve economic activity to instruments mastered in that scope. If all intended transaction portfolios resolve to instruments mastered in the `default` scope, you can omit this field.

## Using Luminesce

You can use the [Lusid.CorporateAction.Source.Writer](/v1/docs/lusidcorporateactionsourcewriter) provider.

## Using the LUSID web app

*Coming soon*