YouTube Trigger: Upgraded Membership
The Upgraded Membership trigger is activated anytime a user upgrades a membership for your YouTube channel. Learn more about upgraded membership levels 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.
Trigger Inputs
Username
The username of the user who upgraded their membership for your YouTube channel.
If the Username field is left blank, the Upgraded Membership trigger will fire regardless of who upgraded their membership. However, if you enter a username in the Username field, the Upgraded Membership trigger will only fire when the specified user upgrades their 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 the users upgraded membership.
If the Level Name field is left blank, the Upgraded Membership trigger will fire regardless of the level name of the upgraded membership. However, if you enter a level name in the Level Name field, the Upgraded Membership trigger will only fire when the level name of the upgraded 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 upgraded their membership for your YouTube channel is verified or not.
If the Is Verified field is left un-set (neither true or false), the Upgraded Membership trigger will fire whether the user who upgraded their membership is verified or not. If the field is set to ‘True’, then the trigger will only fire when the user who upgraded their 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 Below) |
| Required | No |
| Local Variable | Yes |
Is Broadcaster?
Whether or not the user who upgraded their membership for your YouTube channel is the broadcaster (i.e. If you added a message to your own chat).
If the Is Broadcaster field is left un-set (neither true or false), the Upgraded Membership trigger will fire whether the user who upgraded their membership is the broadcaster or not. If the field is set to ‘True’, then the trigger will only fire when the user who upgraded their 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 Below) |
| Required | No |
| Local Variable | Yes |
Is Moderator?
Whether or not the user who upgraded their membership for your YouTube channel is a moderator.
If the Is Moderator field is left un-set (neither true or false), the Upgraded Membership trigger will fire whether the user who upgraded their membership is a moderator or not. If the field is set to ‘True’, then the trigger will only fire when the user who upgraded their membership is a moderator. If this field is set to ‘False’, the trigger will only fire if the user who upgraded their membership is not a moderator.
| Type | Switch (Boolean) |
|---|---|
| Default Fallback | (See Note Below) |
| Required | No |
| Local Variable | Yes |
Is Member?
Whether or not the user who upgraded their membership for 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 Upgraded Membership trigger will fire whether the user who upgraded their membership is a paid member or not. If the field is set to ‘True’, then the trigger will only fire when the user who upgraded their membership is a paid member. If this field is set to ‘False’, the trigger will only fire if the user who upgraded their membership is not a paid member.
| Type | Switch (Boolean) |
|---|---|
| Default Fallback | (See Note Below) |
| Required | No |
| Local Variable | Yes |
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.
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 upgraded their 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 upgraded their 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 upgraded their membership to your YouTube channel.
| Type | Text (String) |
|---|---|
| Default Fallback | (No Default) |
| Min - Max Characters | (No Min - Max) |
| Required | No |
| Local Variable | Yes |