YouTube Trigger: New Membership
The New Membership trigger is activated anytime a user starts a new paid membership for your YouTube channel. Learn more about Memberships on YouTube’s website.
You must have an active broadcast on your YouTube channel in order for this feature to work. Aitum checks your YouTube channel for a new broadcast every few minutes.
There is no default fallback value for Switch fields in Aitum’s YouTube triggers.
You can set a custom fallback value by clicking the cog wheel next to any of the Switch fields (True/False). This value is used only if the value of the field is used as a local variable within that rule. This fallback value will be used if the rule is triggered by another rule, rather than by a chat message being added to your chat.
Trigger Inputs
Username
The username of the user who started a new membership for your YouTube channel.
If the Username field is left blank, the New Membership trigger will fire regardless of who started a new membership. However, if you enter a username in the Username field, the New Membership trigger will only fire when the specified user starts a new membership. The username must match the display name of the desired user exactly. (case sensitive)
| Type | Text (String) |
|---|---|
| Default Fallback | Unknown User |
| Min - Max Characters | (No Min - Max) |
| Required | No |
| Local Variable | Yes |
Level Name
The level name of new membership started by the user.
If the Level Name field is left blank, the New Membership trigger will fire regardless of the level name of the new membership. However, if you enter a level name in the Level Name field, the New Membership trigger will only fire when level name of the new membership is equal to the specified level name.
| Type | Text (String) |
|---|---|
| Default Fallback | (No Default) |
| Min - Max Characters | (No Min - Max) |
| Required | No |
| Local Variable | Yes |
Is Verified?
Whether or not the user who started a new membership for your YouTube channel is verified or not.
If the Is Verified field is left un-set (neither true or false), the New Membership trigger will fire whether the user who started a new membership is verified or not. If the field is set to ‘True’, then the trigger will only fire when the user who started a new membership is using a verified account on YouTube. If this field is set to ‘False’, the trigger will only fire if the users account is un-verified on YouTube.
| Type | Switch (Boolean) |
|---|---|
| Default Fallback | (See Note Above) |
| Required | No |
| Local Variable | Yes |
Is Broadcaster?
Whether or not the user who started a new membership to your YouTube channel is the broadcaster (i.e. If you become a member of your own channel).
If the Is Broadcaster field is left un-set (neither true or false), the New Membership trigger will fire whether the user who started a new membership is the broadcaster or not. If the field is set to ‘True’, then the trigger will only fire when the user who started a new membership is the broadcaster. If this field is set to ‘False’, the trigger will only fire if the users account is not the broadcaster.
| Type | Switch (Boolean) |
|---|---|
| Default Fallback | (See Note Above) |
| Required | No |
| Local Variable | Yes |
Is Moderator?
Whether or not the user who started a new membership to your YouTube channel is a moderator.
If the Is Moderator field is left un-set (neither true or false), the New Membership trigger will fire whether the user who started a new membership is a moderator or not. If the field is set to ‘True’, then the trigger will only fire when the user who started a new membership is a moderator. If this field is set to ‘False’, the trigger will only fire if the user who started a new membership is not a moderator.
| Type | Switch (Boolean) |
|---|---|
| Default Fallback | (See Note Above) |
| Required | No |
| Local Variable | Yes |
Is Member?
Whether or not the user who started a new membership to your YouTube channel is a paid member of your YouTube channel.
If the Is Member field is left un-set (neither true or false), the New Membership trigger will fire whether the user who started a new membership is a paid member or not. If the field is set to ‘True’, then the trigger will only fire when the user who started a new membership is a paid member. If this field is set to ‘False’, the trigger will only fire if the user who started a new membership is not a paid member.
| Type | Switch (Boolean) |
|---|---|
| Default Fallback | (See Note Above) |
| Required | No |
| Local Variable | Yes |
Hidden Variables
Hidden Variables are available as Local Variables within the actions of a rule, but you will not see these fields visually on the Trigger. These can also be used with a New Rule Check, more info here on Checks.
User Profile Image URL
The Profile Image URL of the user who started a new membership to your YouTube channel.
| Type | Text (String) |
|---|---|
| Default Fallback | (No Default) |
| Min - Max Characters | (No Min - Max) |
| Required | No |
| Local Variable | Yes |
User Channel URL
The URL of the users channel who started a new membership to your YouTube channel.
| Type | Text (String) |
|---|---|
| Default Fallback | (No Default) |
| Min - Max Characters | (No Min - Max) |
| Required | No |
| Local Variable | Yes |
Channel ID
The Channel ID of the user who started a new membership to your YouTube channel.
| Type | Text (String) |
|---|---|
| Default Fallback | (No Default) |
| Min - Max Characters | (No Min - Max) |
| Required | No |
| Local Variable | Yes |