> For the complete documentation index, see [llms.txt](https://docs.claimr.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.claimr.io/tasks/youtube-tasks.md).

# YouTube tasks

## What is YouTube task?

Engage users with YouTube content and track their interactions with your channel or videos.

**Use YouTube tasks to:**

* Increase your YouTube channel subscribers.
* Drive views and engagement on your videos.
* Promote your YouTube content within your claimr campaigns.
* Reward users for interacting with your YouTube channel.
* Track the effectiveness of your YouTube marketing efforts.

For detailed information about general task settings, including task name, header, description, rewards, dependencies, and more, refer to [Task settings](/tasks/task-settings.md). 

## **Task type**

This section allows you to choose the specific type of task you want to create for your campaign. 

<figure><img src="/files/JdPvG68K6UZ0tE4y6kLZ" alt="" width="563"><figcaption><p>Task type section</p></figcaption></figure>

1. Select <mark style="color:$success;">**YouTube**</mark> to indicate that the task will be completed with this specific platform.
2. Considering your aim, select the specific task type from the expanded list.

## **Task settings**

### **Submit YouTube video**&#x20;

Reward users for submitting videos on YouTube. This task type helps encourage users to create and share content related to your campaign, brand, or product.

<figure><img src="/files/ME0Tq4cZAFG2V0yVNaj7" alt="" width="563"><figcaption></figcaption></figure>

**Completion points:** Set the number of points awarded when the user completes the task.

**Points multiplier (%):** Add a percentage-based bonus to the total reward. For example, a 10% multiplier increases the final reward by 10%.

**Recurrence:** Control how often users can complete the task:\
– Once – can only be completed one time per user.\
– Daily – available once every 24 hours.\
– Weekly – available once every 7 days.\
– Multiple – stays open and can be completed as many times as needed, one after another, without any waiting time. Read more about this option below.

**Need approval? (optional):** Turn on to require manual review and approval before the task is marked as complete.

### Subscribe to a channel

Reward users for subscribing to a specific YouTube channel.

<figure><img src="/files/0f8aIy14PJSQdF7ux6lR" alt="" width="563"><figcaption></figcaption></figure>

**Completion points:** Set the number of points awarded when the user completes the task.

**Points multiplier (%):** Add a percentage-based bonus to the total reward. For example, a 10% multiplier increases the final reward by 10%.

**YouTube channel ID:** Enter the unique ID of your YouTube channel to enable subscription verification. For example: UCLA\_DiR1fFkNvjvUpBHmylQ. To find it, go to your YouTube channel → About → More → Channel details → Copy channel ID.

<div><figure><img src="/files/eTpEDZPHvGgPItFAIgtv" alt="" width="563"><figcaption><p>Example: Channel details menu</p></figcaption></figure> <figure><img src="/files/FXMaudLsxE6vv7iNNdkg" alt="" width="563"><figcaption><p>Example: Channel details menu</p></figcaption></figure></div>

{% hint style="warning" %}
Remember, accuracy is crucial when entering the ID to ensure Claimr can correctly interact with your YouTube channel.
{% endhint %}

### Watch YouTube video

Reward users for watching a specific YouTube video.

<figure><img src="/files/Ni5MkrQweZoSbULBCaF2" alt="" width="563"><figcaption></figcaption></figure>

**Completion points:** Set the number of points awarded when the user completes the task.

**Points multiplier (%):** Add a percentage-based bonus to the total reward. For example, a 10% multiplier increases the final reward by 10%.

**Recurrence:** Control how often users can complete the task:\
– Once – can only be completed one time per user.\
– Daily – available once every 24 hours.\
– Weekly – available once every 7 days.\
– Multiple – stays open and can be completed as many times as needed, one after another, without any waiting time. Read more about this option below.

**Video ID:** Enter the unique ID of the YouTube video you want users to watch. For example: IGuHERKAiHs. You can find it in the video URL after v=.

**Min watch time in seconds (optional):** Set the minimum time users must watch the video to complete the task. For example, enter 20 to require at least 20 seconds of viewing.

## **Error handling**

While setting up your YouTube task, encountering errors is a possibility. So verify that you've entered the correct YouTube channel ID and video ID in the task settings.&#x20;

{% hint style="warning" %}
If you continue to experience issues, reach out to Claimr's support team for further assistance.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.claimr.io/tasks/youtube-tasks.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.