# First Program Setup

By default HelpYouSponsor provides a new user with one pre-configured recipient sponsorship program and one pre-configured campaign program:

* **Child Sponsorship**: Designed for child sponsorships.
* **General Campaign**: Suitable for general campaign funding.

While these can be great starting points, you may want to create a custom program tailored to your organization's needs. This guide will walk you through the process of creating a complete sponsorship program ready to receive donations.

### Step one: Create a recipient program

To create a recipients program, navigate to **"Recipients"** in under programs the main menu. This will show you all the program under the number pf sponsors and contribution program types.

Click the **"Create a program"** button that will open a drawer with a form to create a program. The form takes in a **"Program Name"** and a **"Program abbreviation"**. Let's create a program called **"Empowering Lives"** and click Save.

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FsPZ2dp2cqcYEn0GXEMvw%2FScreenshot%202025-10-13%20at%207.51.56%E2%80%AFPM.png?alt=media&#x26;token=81be4996-9b62-419b-9549-4ab27599dd0c" alt=""><figcaption></figcaption></figure>

After saving, the form will expand to show a section to attach settings to the program. Attaching settings to the program categorizes the program and adds functionality to it.

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2F00CCGvH7DeJOHuYw8op0%2Fimage.png?alt=media&#x26;token=201e2b3b-a96f-4f1d-a194-92fab532e578" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2F4sgO30GRSkoHX6G1QEbh%2Fimage.png?alt=media&#x26;token=f0ae6c57-5fa7-4581-a33a-a14ddd4ff3ad" alt=""><figcaption></figcaption></figure>

From here, you will have to select a program setting to attach to the program setting. In your case, you will not see the Empowering Lives Setting listed. So to create a program setting, click the "+" icon next to the select list.

This will open a drawer to create the program setting.

### Step Two: Create Program Setting and Attach to Program

Once the drawer opens, you will see the form to create the program setting.

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2Fgty2srQ5OgZeD35BPE8Y%2Fimage.png?alt=media&#x26;token=24a879d8-614e-449c-99ec-117a3d540912" alt=""><figcaption></figcaption></figure>

To learn more about **Program Settings** click [here](https://docs.helpyousponsor.com/guides/core-features/program-management/program-settings).

> **NOTE**: *Each field has a green information icon that gives more information about the field with just one click.*

There are three Program types that a Program Setting can use.

1. **Contribution**: This requires monthly contributions to reach a certain threshold to complete sponsorship.
2. **Number of Sponsors**: This requires a certain number of sponsors to complete sponsorship.
3. **Campaign**: This does not require recipients. The contributions go to the cause.

Let's create a Program Setting of Program Type **"Number of Sponsors"** and call it **"Empowering Lives Setting"** and click Save.

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FOBczacdx7akVQVD9uMCU%2Fimage.png?alt=media&#x26;token=295f22ad-fd59-4cb3-8241-11feb7760532" alt="" width="375"><figcaption></figcaption></figure>

After saving we should see our program setting listed in the select field.&#x20;

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FI1myaoehn5z4dkamCbBr%2Fimage.png?alt=media&#x26;token=f2bdf4bd-fae8-4ca1-83aa-4b2157341858" alt=""><figcaption></figcaption></figure>

To attach the program setting, simply select the Empowering Lives setting and click the **Attach** button.

Once the program setting is attached, the program will be listed under the Number of Sponsors category.

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FZeqRwmCbuTPXqe8u30fR%2Fimage.png?alt=media&#x26;token=52ed3414-9463-485b-8763-c3ed3e3956c2" alt=""><figcaption></figcaption></figure>

### Step Three: Create Recipient Profile and Donor Profile forms and attach them to the Program.

By default HelpYouSponsor provides you with three Forms. These include;

1. **Two Recipient Profile forms:** Used to collect recipient information
   * **Child Profile Form**: Attached to Child Sponsorship program.
   * **Campaign Form**: Attached to General Campaign program.
2. **One Donor form**: Used to collect donor information during donations.
   * S**ponsor Profiles**: Attached to both General Campaign and Child Sponsorship programs.

To learn more about Forms click [here](https://docs.helpyousponsor.com/guides/core-features/program-management/program-forms).

> **NOTE**: *One form can be attached to more than one Program.*

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FyosADsUgXZwqnKyQA66R%2Fimage.png?alt=media&#x26;token=91bd8079-84ea-43aa-8142-3e4e68537012" alt=""><figcaption></figcaption></figure>

To create a program form, go to **"Program Settings"** under **"Programs"** on the main menu and click on the **"Forms"** tab and click the **"Create Form"** button. This will open up a drawer with a form for creating Program Forms.

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FVFc9DAMGOMBpmLIvUGY8%2Fimage.png?alt=media&#x26;token=62ca176f-d479-43d5-86c3-7066b88db36d" alt=""><figcaption></figcaption></figure>

Let's create a Recipient Profile form called **"Empowerment Recipients"** and a Donor Profile form called **"Empowerment Donors"**.

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FKj5aTAZ8t912vwyc0etS%2Fimage.png?alt=media&#x26;token=d3cddec9-b6f4-48ea-9ce3-bb91313bbf3f" alt=""><figcaption></figcaption></figure>

Next we need to add fields to our Program forms. These fields represent the data that will be collected from the donors and the recipients. To add fields, click on the **"Manage Fields"** button. This will open up a drawer for adding new fields to the form. To add a field make sure you are in the **"Add New Field"** tab. You can add as many fields as you like.

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FNN9y99tJAHQTaFBkqETR%2Fimage.png?alt=media&#x26;token=1f65d3dd-b8a6-4f6c-ae8a-9edc9e21a44a" alt=""><figcaption></figcaption></figure>

Lets create two fields \[Name (field type: text) and Age (field type: age)] in Empowerment Recipients and One field \[Name (field type: text)] in Empowerment Donors.

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FDAkxRqOaB0komZsB9wkR%2Fimage.png?alt=media&#x26;token=4de677cb-50fa-4ab6-97dd-f5f36eb0399e" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FlSXKGxtiwdigl3A55NhU%2Fimage.png?alt=media&#x26;token=0ee7977a-a70b-4323-b9e5-0b3fb20766d6" alt=""><figcaption></figcaption></figure>

Next let us attach the two Program forms to our **"Empowering Lives"** program. Go back to recipients under Programs and click on the Settings icon for Empowering Lives and got to the **"Forms"** tab in the opened drawer.

Our newly created Program forms should be listed in the Donor form and Recipient form respectively. Select them and click the **"Attach"** button on each one.

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FNXG3BKaVIyOW4g28untr%2Fimage.png?alt=media&#x26;token=59de011a-36e5-4fdf-b9ea-a089bcbdd0cd" alt=""><figcaption></figcaption></figure>

### Step Four: Create Auto Email Set and attach it to the program.

To create an Auto Email Set, click **"Auto Emails"** in the main menu under **"Communications"**. Here you will see the default Auto Email Set provided by HelpYouSponsor.

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FkTcUcw195hJ2CtdeUBJw%2Fimage.png?alt=media&#x26;token=32f0f7d0-02af-49a5-8e05-10aeea1cb278" alt=""><figcaption></figcaption></figure>

Let us create a new Auto Email Set by clicking the **"Create Auto Email set"** button. This will open up a drawer with the form to create one. Let's call the Auto Email Set **"Empowering Emails"** with a from email address as **"<demo@helpyousponsor.com>"** and click Save.

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FPX7L61CT8WnB3fFvtxOr%2Fimage.png?alt=media&#x26;token=ff5b886c-99e1-4d37-9eaa-2cc5e7ab7531" alt=""><figcaption></figcaption></figure>

We should now be able to see our new Auto Email set listed.

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2F3q6On1z1uD9af6qPHlKA%2Fimage.png?alt=media&#x26;token=1942dcd8-07b4-40b6-b0b0-f5ea39891703" alt=""><figcaption></figcaption></figure>

&#x20;To learn more about Auto Emails click [here](https://docs.helpyousponsor.com/guides/core-features/communication-tools/auto-emails).

Let us attach our new Auto Email set to our program. To attach the Auto Email set to our program, click on the **"Programs**" tab and click on the **"Settings"** icon. In the drawer that opens click on the **"Emails"** tab.

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FIBq9BCjjjpGo13xqYOX3%2Fimage.png?alt=media&#x26;token=2aa12a57-3675-4016-84c8-2c9481070218" alt=""><figcaption></figcaption></figure>

Select the Auto Email Set and click the **"Attach"** button to attach the Auto Email Set to the program.

After attaching the Auto Email set, you should now see a green tick next to the program name in Manage Programs. This indicates the the Program had been fully setup.

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FgAGt3eVuxA2xHdKHUXFH%2Fimage.png?alt=media&#x26;token=06ed8813-68bd-4746-b26c-33ebc2151e6b" alt=""><figcaption></figcaption></figure>

### Step Five: Add recipients to your Program.

Next we need to add recipients to the program so that they can be sponsored and receive donations from the donors.

To add recipients to our program, navigate to **"Recipients"** under **"Programs"** on the main menu and click **"View Recipients"** on the **"Empowering Lives"** Program.

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2F3jufkLStoc6GcDeXrX4v%2Fimage.png?alt=media&#x26;token=b3335d6c-7a78-4044-a24d-9562f0330eaa" alt=""><figcaption></figcaption></figure>

This will show you all the key features in the Program.

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FZYWwoDFsJnBlU0GQEKws%2Fimage.png?alt=media&#x26;token=bd69bd01-67ed-4e6a-a786-d13a59760ce2" alt=""><figcaption></figcaption></figure>

To add a recipient to the program, click the **"Add Recipient"** button. This will open up a drawer showing you a form with the fields you added to the **"Empowerment Recipients"** form and the necessary fields from the **"Empowering Lives Setting"** program setting that was attached.

Let's create our first recipient John Dow and hit Save.

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FEJio6C8H0dLg6gxGTP2k%2Fimage.png?alt=media&#x26;token=70f4864b-acb7-4294-9a70-de14ce9c4c20" alt=""><figcaption></figcaption></figure>

The recipients table should now show the added recipient.

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FfIphZoAwg8DJO6jvzgM5%2Fimage.png?alt=media&#x26;token=94184c12-af3f-4a29-84df-c5b0ef22936d" alt=""><figcaption></figcaption></figure>

After these five steps, you have your Program ready with recipients to receive donations from donors.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.helpyousponsor.com/guides/getting-started/account-setup/first-program-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
