# DonorDrive

## Getting Started

The Donor Drive feature allows you to connect Mix It Up with your Donor Drive-based charity for donation alerts for you and your team. To connect DonorDrive in Mix It Up, visit your charity's website and look for your page/participant link. Then select your charity from the drop-down or select Custom if it's not in the list, copy your page/participant link into the text box, and select Log In.

This service works with the [Donor Drive Donation Event](/docs/integrations/donor-drive#donor-drive-donation-1-minute-delay).

This service exposes the following [Special Identifiers](/docs/reference/special-identifiers) which can be used in all commands:

- $donordriveuserdonationgoal = The donation goal for you.
- $donordriveuserdonationcount = The total number of donations for you.
- $donordriveuserdonationamount = The total $ amount of donations for you.
- $donordriveteamdonationgoal = The donation goal for your team.
- $donordriveteamdonationcount = The total number of donations for your team.
- $donordriveteamdonationamount = The total $ amount of donations for your team.

## Events

### Donor Drive Donation (1 Minute Delay)
This event fires when a Donor Drive donation is detected. It provides all of the [Donations](/docs/reference/special-identifiers#donations) special identifiers along with all of the standard [User](/docs/reference/special-identifiers#user) special identifiers that represent the user that sent the donation. Additionally, you can use the globally available [Donor Drive](/docs/integrations/donor-drive) special identifiers with this command and others.
- $donordriverecipientname = The name of the user who received the donation (IE, the streamer)
- $donordriverecipientimageurl = The image URL of the user who received the donation (IE, the streamer)

### Donor Drive Donation Incentive (1 Minute Delay)

This event fires when a Donor Drive Incentive is included in a donation. It provides all of the [Donations](/docs/reference/special-identifiers#donations) special identifiers along with all of the standard [User](/docs/reference/special-identifiers#user) special identifiers that represent the user that sent the donation. Additionally, you can use the globally available [Donor Drive](/docs/integrations/donor-drive) special identifiers with this command and others. The following additional Special Identifiers are available:
- $donordriveincentivedescription = The description text of the incentive

### Donor Drive Donation Milestone (1 Minute Delay)

This event fires when a Donor Drive Milestone has been reached. It provides all of the [Donations](/docs/reference/special-identifiers#donations) special identifiers along with all of the standard [User](/docs/reference/special-identifiers#user) special identifiers that represent the user that sent the donation. Additionally, you can use the globally available [Donor Drive](/docs/integrations/donor-drive) special identifiers with this command and others. The following additional Special Identifiers are available:
- $donordrivemilestonedescription = The description text of the milestone
- $donordrivemilestoneamountnumber = The amount associated with the milestone as a pure decimal number (EX: 12.34)
- $donordrivemilestoneamount = The amount associated with the milestone (EX: $12.34)

### Donor Drive Team Donation Incentive (1 Minute Delay)

This event fires when a Donor Drive Team Incentive is included in a donation. It provides all of the [Donations](/docs/reference/special-identifiers#donations) special identifiers along with all of the standard [User](/docs/reference/special-identifiers#user) special identifiers that represent the user that sent the donation. Additionally, you can use the globally available [Donor Drive](/docs/integrations/donor-drive) special identifiers with this command and others.

Team incentives are only included if the "Include Team Donations / Events" option is toggled under Services -> DonorDrive.

The following additional Special Identifiers are available:
- $donordriveincentivedescription = The description text of the incentive

### Donor Drive Team Donation Milestone (1 Minute Delay)

This event fires when a Donor Drive Team Milestone has been reached. It provides all of the [Donations](/docs/reference/special-identifiers#donations) special identifiers along with all of the standard [User](/docs/reference/special-identifiers#user) special identifiers that represent the user that sent the donation. Additionally, you can use the globally available [Donor Drive](/docs/integrations/donor-drive) special identifiers with this command and others.

Team incentives are only included if the "Include Team Donations / Events" option is toggled under Services -> DonorDrive.

The following additional Special Identifiers are available:
- $donordrivemilestonedescription = The description text of the milestone
- $donordrivemilestoneamountnumber = The amount associated with the milestone as a pure decimal number (EX: 12.34)
- $donordrivemilestoneamount = The amount associated with the milestone (EX: $12.34)