{
  "key": "google_ads_access",
  "title": "Give us access to Google Ads",
  "variables": {
    "who_needs_access": {
      "type": "email_list",
      "label": "Team emails needing access",
      "required": true
    }
  },
  "start": "submit_customer_id",
  "steps": [
    {
      "id": "submit_customer_id",
      "owner": "client",
      "instruction": "Your customer ID lets us send an access request to exactly the right account. In [Google Ads](https://ads.google.com), it's at the top right of any page, formatted like 123-456-7890.",
      "tutorial": {
        "title": "Finding your Google Ads customer ID",
        "intro": "It's a 10-digit number that identifies your Ads account — it takes about thirty seconds to find.",
        "steps": [
          {
            "text": "Go to [ads.google.com](https://ads.google.com) and sign in."
          },
          {
            "text": "Look at the **top-right of the page**, near your account name and avatar. The customer ID sits right there.",
            "note": "It's formatted like 123-456-7890. Include the dashes or don't — either is fine.",
            "image": "asset://ads-01-customer-id.png"
          },
          {
            "text": "Copy it, come back here and paste it in.",
            "note": "Several accounts listed? Give us the one that runs the ads for this business. If you're not sure, send them all in a comment and we'll work it out."
          }
        ]
      },
      "fields": [
        {
          "key": "customer_id",
          "type": "text",
          "label": "Customer ID",
          "required": true,
          "pattern": "^\\d{3}-?\\d{3}-?\\d{4}$",
          "hint": "it usually looks like 123-456-7890"
        }
      ],
      "primary": {
        "label": "Submit ID",
        "to": "team_request"
      },
      "alternatives": [
        {
          "key": "later",
          "label": "I'll do it later",
          "kind": "flag",
          "tone": "ack"
        },
        {
          "key": "trouble",
          "label": "Having trouble",
          "kind": "flag",
          "tone": "attention"
        }
      ],
      "control": "input"
    },
    {
      "id": "team_request",
      "owner": "team",
      "instruction": "From the MCC, send a manager-link request to customer {{fields.submit_customer_id.customer_id}} covering {{who_needs_access}}.",
      "primary": {
        "label": "Access requested",
        "to": "client_accept"
      }
    },
    {
      "id": "client_accept",
      "owner": "client",
      "instruction": "You'll have an email from Google (\"...wants to manage your Google Ads account\"). Or in Google Ads: Admin > Access and security > Managers tab > Accept.",
      "tutorial": {
        "title": "Accepting our access request",
        "intro": "We've sent a request from our manager account. You just need to say yes.",
        "steps": [
          {
            "text": "Check your email for a message from Google — the subject is along the lines of \"...wants to manage your Google Ads account\".",
            "note": "It can land in Promotions or Spam. If you can't find it, the next step gets there without the email."
          },
          {
            "text": "Either click **Accept** in that email, or go to [ads.google.com](https://ads.google.com) and open **Admin** > **Access and security** > the **Managers** tab.",
            "image": "asset://ads-02-managers-tab.png"
          },
          {
            "text": "Find our request in the list and click **Accept**.",
            "note": "Accepting doesn't hand over billing or ownership — you stay in control and can remove us at any time from this same screen."
          },
          {
            "text": "Come back and press **Accepted**."
          }
        ]
      },
      "primary": {
        "label": "Accepted",
        "to": "team_verify"
      },
      "alternatives": [
        {
          "key": "cant_find",
          "label": "I can't find the request",
          "kind": "flag",
          "tone": "attention"
        }
      ]
    },
    {
      "id": "team_verify",
      "owner": "team",
      "instruction": "Confirm the account appears in the MCC and {{who_needs_access}} can open it.",
      "primary": {
        "label": "Confirmed",
        "to": "$done"
      },
      "alternatives": [
        {
          "key": "not_linked",
          "label": "Not linked — back to the client",
          "kind": "jump",
          "to": "client_accept"
        }
      ]
    }
  ]
}