From 61718066ba07b8abafa931e095b78539499e2192 Mon Sep 17 00:00:00 2001 From: Michelle Chu Date: Tue, 12 Dec 2023 10:23:39 -0800 Subject: [PATCH 1/6] Update partner API section with webintent URL --- docs/_embed/quick-account-creation.md | 23 ++++++++++++++++++----- 1 file changed, 18 insertions(+), 5 deletions(-) diff --git a/docs/_embed/quick-account-creation.md b/docs/_embed/quick-account-creation.md index 2e485579..cdb00eda 100644 --- a/docs/_embed/quick-account-creation.md +++ b/docs/_embed/quick-account-creation.md @@ -43,14 +43,27 @@ If you have an existing Full Zapier Experience or Zap templates element embed, y ## Add support to the Partner API -1. Retrieve your integration's name from the "title" field returned from the [`/apps` endpoint](https://platform.zapier.com/embed/partner-api#get-v1apps). -2. Redirect users to the acknowledgement page URL below: -`https://zapier.com/partner/acknowledgment?sign-up-last-name=&next=%2Fapp%2Fdashboard&type=quac&name=&sign-up-first-name=&sign-up-email=` -3. Replace the following query parameter placeholders in the URL, using the "title" value from step 1 for the "name" parameter: -- name=`` +1. Send users to the URL below to create an account and redirect them into the Editor setup with the Zap template set in the parameters: +`https://zapier.com/webintent/create-zap? +template=& +utm_source=partner& +utm_medium=embed& +utm_campaign=zap_templates_element& +entry-point-location=partner_embed& +referer=& +referrer=& +sign-up-first-name=& +sign-up-last-name=& +sign-up-email=& +client-id=` +2. Replace the following query parameter placeholders in the URL: +- client-id=`` +- template=`` - sign-up-first-name=`` - sign-up-last-name=`` - sign-up-email=`` +- referer=`` +- referrer=`` After an account is created, a [user token still needs to be procured](https://platform.zapier.com/embed/partner-api#access-token) to access specific Partner API endpoints. Generally, since the user will already be signed in to their newly created account in an active session on Zapier, users won't have to explicitly sign in again when prompted with Zapier's OAuth flow. From b010684cfdbc78bdbb80fae076f5ea56e7f0236c Mon Sep 17 00:00:00 2001 From: Michelle Chu Date: Fri, 15 Dec 2023 10:16:33 -0800 Subject: [PATCH 2/6] Update utm parameters in webintent URL --- docs/_embed/quick-account-creation.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/_embed/quick-account-creation.md b/docs/_embed/quick-account-creation.md index cdb00eda..732b1283 100644 --- a/docs/_embed/quick-account-creation.md +++ b/docs/_embed/quick-account-creation.md @@ -48,7 +48,8 @@ If you have an existing Full Zapier Experience or Zap templates element embed, y template=& utm_source=partner& utm_medium=embed& -utm_campaign=zap_templates_element& +utm_campaign=partner_api& +utm_content=partner_quick_account_creation& entry-point-location=partner_embed& referer=& referrer=& From 7e4e3149010f47b2d39bfdf43d7ff418ea3f65af Mon Sep 17 00:00:00 2001 From: Michelle Chu Date: Fri, 15 Dec 2023 10:21:52 -0800 Subject: [PATCH 3/6] Update wording --- docs/_embed/quick-account-creation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/_embed/quick-account-creation.md b/docs/_embed/quick-account-creation.md index 732b1283..1e26b618 100644 --- a/docs/_embed/quick-account-creation.md +++ b/docs/_embed/quick-account-creation.md @@ -43,7 +43,7 @@ If you have an existing Full Zapier Experience or Zap templates element embed, y ## Add support to the Partner API -1. Send users to the URL below to create an account and redirect them into the Editor setup with the Zap template set in the parameters: +1. Use the URL below to initiate Quick Account Creation, then redirect users into the Editor with the Zap template set in the parameters: `https://zapier.com/webintent/create-zap? template=& utm_source=partner& From a6ef587250b11fd3a10a347669e6420cbcadc6f0 Mon Sep 17 00:00:00 2001 From: Michelle Chu Date: Fri, 15 Dec 2023 10:27:53 -0800 Subject: [PATCH 4/6] Update style of Zap editor --- docs/_embed/quick-account-creation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/_embed/quick-account-creation.md b/docs/_embed/quick-account-creation.md index 1e26b618..dd38aed8 100644 --- a/docs/_embed/quick-account-creation.md +++ b/docs/_embed/quick-account-creation.md @@ -43,7 +43,7 @@ If you have an existing Full Zapier Experience or Zap templates element embed, y ## Add support to the Partner API -1. Use the URL below to initiate Quick Account Creation, then redirect users into the Editor with the Zap template set in the parameters: +1. Use the URL below to initiate Quick Account Creation, then redirect users into the Zap editor with the Zap template set in the parameters: `https://zapier.com/webintent/create-zap? template=& utm_source=partner& From a0a1789bf6ee789c35c3d37131e3c29d1d45b8d3 Mon Sep 17 00:00:00 2001 From: Michelle Chu Date: Fri, 15 Dec 2023 11:31:26 -0800 Subject: [PATCH 5/6] Replace parameter list with table --- docs/_embed/quick-account-creation.md | 32 ++++++++++----------------- 1 file changed, 12 insertions(+), 20 deletions(-) diff --git a/docs/_embed/quick-account-creation.md b/docs/_embed/quick-account-creation.md index dd38aed8..33b5eca7 100644 --- a/docs/_embed/quick-account-creation.md +++ b/docs/_embed/quick-account-creation.md @@ -44,27 +44,19 @@ If you have an existing Full Zapier Experience or Zap templates element embed, y ## Add support to the Partner API 1. Use the URL below to initiate Quick Account Creation, then redirect users into the Zap editor with the Zap template set in the parameters: -`https://zapier.com/webintent/create-zap? -template=& -utm_source=partner& -utm_medium=embed& -utm_campaign=partner_api& -utm_content=partner_quick_account_creation& -entry-point-location=partner_embed& -referer=& -referrer=& -sign-up-first-name=& -sign-up-last-name=& -sign-up-email=& -client-id=` +``` +https://zapier.com/webintent/create-zap?template=&utm_source=partner&utm_medium=embed&utm_campaign=partner_api&utm_content=partner_quick_account_creation&entry-point-location=partner_embed&referer=&referrer=&sign-up-first-name=&sign-up-last-name=&sign-up-email=&client-id= +``` + 2. Replace the following query parameter placeholders in the URL: -- client-id=`` -- template=`` -- sign-up-first-name=`` -- sign-up-last-name=`` -- sign-up-email=`` -- referer=`` -- referrer=`` +| Parameter | Requirement | Explanation | +| :---------------------: | :---------: | -------------------------------------------------------------------------------------------------- | +| **client_id** | Required | Your application Client ID. | +| **template** | Required | An ID of a Zap Template. | +| **sign-up-first-name** | Required | First name of the user signing up. | +| **sign-up-last-name** | Required | Last name of the user signing up. | +| **sign-up-email** | Required | Email address of the user signing up. | +| **refer** or **referrer**| Required | URL of the page where the user clicked the link. | After an account is created, a [user token still needs to be procured](https://platform.zapier.com/embed/partner-api#access-token) to access specific Partner API endpoints. Generally, since the user will already be signed in to their newly created account in an active session on Zapier, users won't have to explicitly sign in again when prompted with Zapier's OAuth flow. From 82a5b27f36f501f47db6dc990d029ae3a3f7706f Mon Sep 17 00:00:00 2001 From: Michelle Chu Date: Fri, 15 Dec 2023 11:32:30 -0800 Subject: [PATCH 6/6] Add newline before table --- docs/_embed/quick-account-creation.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/_embed/quick-account-creation.md b/docs/_embed/quick-account-creation.md index 33b5eca7..e7424573 100644 --- a/docs/_embed/quick-account-creation.md +++ b/docs/_embed/quick-account-creation.md @@ -49,6 +49,7 @@ https://zapier.com/webintent/create-zap?template=&utm_source=pa ``` 2. Replace the following query parameter placeholders in the URL: + | Parameter | Requirement | Explanation | | :---------------------: | :---------: | -------------------------------------------------------------------------------------------------- | | **client_id** | Required | Your application Client ID. |