---
title: "Corporate actions"
slug: "corporate-actions"
updated: 2024-09-23T12:02:39Z
published: 2024-09-23T12:02:39Z
canonical: "support.lusid.com/corporate-actions"
---

> ## 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.

# Corporate actions

A *corporate action* is an elective activity that impacts the shareholders and/or bondholders of a company, for example a dividend, stock split or spin off. [See the list of dedicated corporate action events](/v1/docs/understanding-dedicated-corporate-action-events).

You can create a *corporate action source* in LUSID and upload your stream of corporate actions from an external provider to it. You can then subscribe any number of transaction portfolios to the corporate action source, and LUSID automatically applies corporate actions to portfolios with holdings in the underlying instruments on appropriate dates.

For example, you could upload a corporate action representing a Microsoft cash dividend of $0.20 per share that has an ex-dividend date of 6 February and a payment date of 10 February. For each portfolio with a holding in Microsoft on 6 February, LUSID automatically increases the cash balance by 20 cents per unit held on 10 February (or an equivalent amount in an elective currency). [See this in action](/v1/docs/handling-a-cash-dividend-corporate-action-event).

Providing you have appropriate permissions, you can create a corporate action source and upload corporate actions to it using the [LUSID web app](https://www.lusid.com/app/home), via the **Data Management > Corporate Actions** dashboard:

![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/93683dc3-cef8-4100-81e7-75151509b147.png)

Alternatively, you can perform these operations programmatically:

- Using the [LUSID API endpoints](https://jamleed.lusid.com/docs/api/lusid/intro) in the `Corporate Action Sources` collection.
- Using equivalent methods in the [LUSID SDK](/v1/docs/understanding-all-the-applications-in-the-finbourne-platform) in various languages.
- If you have a Luminesce license, using dedicated [read and write providers](/v1/docs/using-luminesce-to-readwrite-lusid-investment-data#corporate-actions).

**Explanation**: *See the big picture*

- [Understanding dedicated corporate action events](/v1/docs/understanding-dedicated-corporate-action-events)

**Tutorials**: *Get started by doing something tangible*

- [Handling a cash dividend corporate action event](/v1/docs/handling-a-cash-dividend-corporate-action-event)

**Reference**: *Understand concepts and inplications*

- [Loading an event instruction to override a corporate action event for a particular portfolio](/v1/docs/loading-an-event-instruction-to-override-an-instrument-event-for-a-particular-portfolio)
- [Modelling unsupported corporate actions as transition events](/v1/docs/modelling-unsupported-corporate-actions-as-transition-events)

**How-to guides**: *Get something done*

- [How do I create a corporate action source?](/v1/docs/how-do-i-create-a-corporate-action-source)
- [How do I upload corporate actions to a corporate action source?](/v1/docs/how-do-i-upload-corporate-actions-to-a-corporate-action-source)