Duda

App · 25 actions

Build and run your clients' websites on Duda: make sites from templates, publish them, set up client accounts with access and sign-in links, and keep content libraries and collections up to date. Start a workflow when a form is sent, a site is made or published, or a collection gets a row.

Actions

ActionWhat it does
Add collection rowAdd a row to a site's collection.
Back up siteSave a restore point of a site, such as before changes are made.
Create accountAdd a client or team member account.
Create collectionAdd a collection (a table of content a site's pages can show) to a site, with its fields.
Create sign-in linkMake a link that signs an account in to Duda without a password and opens its dashboard, a site's editor or another page.
Create siteMake a new site from a template, with the business's details.
Delete accountDelete a client or team member account for good.
Delete collection rowsDelete rows from a site's collection.
Delete siteDelete a site for good and cancel its plan.
Duplicate siteMake a copy of a site, unpublished, with its own default address.
Get accountGet a client or team member account's details.
Get content libraryGet a site's content library: the business's name, logo, phones, emails, address, opening hours, social profiles, texts and images.
Get siteGet a site's details: its business, domain, publish status and dates, and links to edit and preview it.
Get site analyticsGet a site's visits, visitors and page views, or its calls, map clicks, email clicks and form submissions, over a period.
Grant site accessLet an account work on a site, with what it may do there, such as edit or see stats.
List collectionsList a site's collections with their fields and rows, or get one collection.
List form submissionsList what visitors sent through a site's contact forms, newest first, with every field filled in.
List sitesList your Duda sites, newest first, by publish status or the day they were made.
List templatesList the templates a site can be made from: Duda's and your own.
Publish content libraryPut a site's content library changes on its live site.
Publish sitePut a site live, or put changes made since the last publish live.
Unpublish siteTake a site offline.
Update collection rowChange some fields of a row in a site's collection.
Update content libraryChange a site's business details, address and texts in its content library.
Update siteChange a site's domain, address, references, SEO settings, favicon or Google tags.

Add collection row

Add a row to a site's collection.

Inputs

SitesitetextRequired
The site, or its site name from another Duda step.
CollectioncollectiontextRequired
The collection, or its name.
FieldsdataobjectRequired
The row's values, by field. Choose the site and collection to fill them in one by one, or give an object from an earlier step.
Showsstatustext
Where the row shows up. Leave blank for live on a new row, or to keep it as it is on an existing one.One of: ACTIVE (Live (on the site and in the editor)), PREVIEW (Editor only), DRAFT (Draft (in the collection only)).
Publish to the live sitepublishtrue/false
Also publish the collection, so a published site shows the change at once. Off, it waits for the next publish.Default: false.

Outputs

collectiontext
The collection's name
publishedtrue/false
True if the collection was published to the live site
row_idtext
The row's ID
site_nametext
The site's name in Duda (its ID), which the other Duda steps take
Example output
{
  "collection": "events",
  "published": false,
  "row_id": "144",
  "site_name": "6c56394c"
}

Back up site

Save a restore point of a site, such as before changes are made. A site keeps up to 50 backups made this way; restore one in Duda.

Inputs

SitesitetextRequired
The site, or its site name from another Duda step.
Namenametext
A name for the backup, such as before-redesign. Spaces become hyphens.

Outputs

backup_nametext
The backup's name, to restore it from in Duda
site_nametext
The site's name in Duda (its ID), which the other Duda steps take
Example output
{
  "backup_name": "QA-Complete",
  "site_name": "6c56394c"
}

Create account

Add a client or team member account. Duda doesn't email them: give them a site with 'Grant site access', then a link from 'Create sign-in link'.

Inputs

Account nameaccount_nametextRequired
A name for the account that no other account has, usually their email. Up to 150 characters.
First namefirst_nametextRequired
Their first name.
Last namelast_nametextRequired
Their last name.
Emailemailtext
Their email.
Companycompany_nametext
Their company.
Typeaccount_typetext
A client, or a member of your team. Defaults to a client.One of: CUSTOMER (Client), STAFF (Team member). Default: CUSTOMER.
Languagelanguagetext
The language Duda's screens show them.One of: en (English), en_gb (English (UK)), ar (Arabic), nl (Dutch), fr (French), de (German), id (Indonesian), it (Italian), ja (Japanese), pl (Polish), and 4 more.

Outputs

account_nametext
The account's name in Duda, which the other Duda steps take
account_typetext
CUSTOMER for a client, STAFF for a team member
company_nametext
The account holder's company
emailtext
The account holder's email
first_nametext
The account holder's first name
languagetext
The language Duda's screens show them, such as en
last_nametext
The account holder's last name
Example output
{
  "account_name": "uniqueAcctReference",
  "account_type": "CUSTOMER",
  "company_name": "Joann's Agency",
  "email": "example@domain.com",
  "first_name": "Joann",
  "language": "en",
  "last_name": "Smith"
}

Create collection

Add a collection (a table of content a site's pages can show) to a site, with its fields. Name fields with letters, numbers, hyphens and underscores.

Inputs

SitesitetextRequired
The site, or its site name from another Duda step.
NamenametextRequired
What the collection is called.
Text fieldstext_fieldslist
Fields of plain text.
Rich text fieldsrich_text_fieldslist
Fields of formatted text.
Number fieldsnumber_fieldslist
Fields of numbers.
Date fieldsdate_fieldslist
Fields of dates and times.
Image fieldsimage_fieldslist
Fields holding a link to an image.
Link fieldslink_fieldslist
Fields of links.
Email fieldsemail_fieldslist
Fields of emails.
Phone fieldsphone_fieldslist
Fields of phone numbers.

Outputs

fieldslist
Its fields
nametext
The new collection's name
site_nametext
The site's name in Duda (its ID), which the other Duda steps take
Example output
{
  "fields": [
    {
      "name": "location",
      "type": "plain_text"
    },
    {
      "name": "date",
      "type": "date_time"
    }
  ],
  "name": "events",
  "site_name": "6c56394c"
}

Make a link that signs an account in to Duda without a password and opens its dashboard, a site's editor or another page. It works once, within two minutes, so make it just before it's used.

Inputs

Account nameaccount_nametextRequired
The client account's name in Duda, usually the email it was made with.
Opensdestinationtext
Where the link takes them. Defaults to the dashboard.One of: DASHBOARD, EDITOR (Site editor), SITE_OVERVIEW (Site overview), STATS (Site stats), SITE_SEO_OVERVIEW (SEO overview), STORE_MANAGEMENT (Store management), SWITCH_TEMPLATE (Choose a new template, keeping the content), RESET_SITE (Start over from a new template), RESET_BASIC (Simple editor), SWITCH_TEMPLATE_WITH_AI (AI site builder), SWITCH_GENERATE_TEMPLATE_CONTENT (Fill the template with AI content), VIBE. Default: DASHBOARD.
Sitesitetext
The site it opens. Needed for everything but the dashboard and Vibe.

Outputs

account_nametext
The account's name in Duda, which the other Duda steps take
destinationtext
Where it opens, such as DASHBOARD or EDITOR
site_nametext
The site it opens; empty for the dashboard
urltext
The sign-in link; it works once, within two minutes
Example output
{
  "account_name": "uniqueAcctReference",
  "destination": "EDITOR",
  "site_name": "6c56394c",
  "url": "https://example.com/home/site/6c56394c?sso=token"
}

Create site

Make a new site from a template, with the business's details. It isn't live until it's published.

Inputs

TemplatetemplatetextRequired
The template to build it from.
Business namebusiness_nametext
The business the site is for.
Address prefixdefault_domain_prefixtext
The first part of the site's default address, such as joes-pizza. Letters, numbers and hyphens. Leave blank for Duda to choose.
External IDexternal_idtext
Your own reference for the site, such as its ID in your CRM.
Labelslabelslist
Labels to file the site under in Duda.
Business emailbusiness_emailtext
The business's email.
Business phonebusiness_phonetext
The business's phone number.
Streetstreettext
The business's street address.
Citycitytext
The business's city.
Statestatetext
The business's state or region.
ZIP codezip_codetext
The business's ZIP or postcode.
Countrycountrytext
The business's country.
SEO titleseo_titletext
The site's title for search engines.
SEO descriptionseo_descriptiontext
The site's description for search engines.

Outputs

account_nametext
The account that owns the site, usually an email
business_emailtext
The business's email
business_nametext
The business the site is for
business_phonetext
The business's phone number
canonical_urltext
The address search engines are sent to
citytext
The business's city
countrytext
The business's country
created_attext
When the site was made (ISO 8601, UTC)
default_domaintext
The site's default address on your Duda domain
editortext
The editor it's built in: SIMPLE, ADVANCED, ADVANCED-2.0 or VIBE
editor_urltext
A link to open the site in the editor
external_idtext
Your own reference for the site; empty if none
first_published_attext
When it was first published (ISO 8601, UTC); empty if never
labelslist
The site's labels
languagetext
The site's main language, such as en
last_published_attext
When it was last published (ISO 8601, UTC); empty if never
modified_attext
When the site last changed (ISO 8601, UTC)
overview_urltext
A link to the site's overview in the dashboard
preview_urltext
A link to preview the site
publish_statustext
PUBLISHED, UNPUBLISHED or NOT_PUBLISHED_YET
seo_descriptiontext
The site's description for search engines
seo_titletext
The site's title for search engines
site_domaintext
The site's own domain, such as example.com; empty if none
site_nametext
The site's name in Duda (its ID), which the other Duda steps take
statetext
The business's state or region
streettext
The business's street address
template_idnumber
The ID of the template it was made from
thumbnail_urltext
A picture of the site
zip_codetext
The business's ZIP or postcode
Example output
{
  "account_name": "owner@example.com",
  "business_email": "business@example.com",
  "business_name": "Example Business",
  "business_phone": "(123) 456-7890",
  "canonical_url": "https://www.example.com/",
  "city": "San Francisco",
  "country": "United States",
  "created_at": "2016-04-01T04:36:54Z",
  "default_domain": "example.multiscreensite.com",
  "editor": "ADVANCED",
  "editor_url": "https://example.com/home/site/6c56394c",
  "external_id": "an-external-reference",
  "first_published_at": "2016-04-03T04:36:54Z",
  "labels": [
    "QA team",
    "priority client"
  ],
  "language": "en",
  "last_published_at": "2016-11-15T22:55:53Z",
  "modified_at": "2016-11-15T22:55:53Z",
  "overview_url": "https://example.com/home/dashboard/overview/6c56394c",
  "preview_url": "https://example.com/link/to/preview",
  "publish_status": "PUBLISHED",
  "seo_description": "A description of the website.",
  "seo_title": "Example Title",
  "site_domain": "example.com",
  "site_name": "6c56394c",
  "state": "CA",
  "street": "1240 Main ST.",
  "template_id": 1027437,
  "thumbnail_url": "https://example.com/link/to/image",
  "zip_code": "94122"
}

Delete account

Delete a client or team member account for good. Its sites stay.

Inputs

Account nameaccount_nametextRequired
The client account's name in Duda, usually the email it was made with.

Outputs

account_nametext
The account's name in Duda, which the other Duda steps take
deletedtrue/false
True once it's deleted
Example output
{
  "account_name": "uniqueAcctReference",
  "deleted": true
}

Delete collection rows

Delete rows from a site's collection.

Inputs

SitesitetextRequired
The site, or its site name from another Duda step.
CollectioncollectiontextRequired
The collection, or its name.
Row IDsrowslistRequired
The IDs of the rows to delete.
Publish to the live sitepublishtrue/false
Also publish the collection, so a published site shows the change at once. Off, it waits for the next publish.Default: false.

Outputs

collectiontext
The collection's name
countnumber
How many rows were deleted
deleted_row_idslist
The IDs of the rows deleted
publishedtrue/false
True if the collection was published to the live site
site_nametext
The site's name in Duda (its ID), which the other Duda steps take
Example output
{
  "collection": "events",
  "count": 2,
  "deleted_row_ids": [
    "144",
    "145"
  ],
  "published": false,
  "site_name": "6c56394c"
}

Delete site

Delete a site for good and cancel its plan. This can't be undone.

Inputs

SitesitetextRequired
The site, or its site name from another Duda step.

Outputs

deletedtrue/false
True once it's deleted
site_nametext
The site's name in Duda (its ID), which the other Duda steps take
Example output
{
  "deleted": true,
  "site_name": "6c56394c"
}

Duplicate site

Make a copy of a site, unpublished, with its own default address.

Inputs

SitesitetextRequired
The site to copy.
Address prefixnew_domain_prefixtextRequired
The first part of the copy's default address, such as joes-pizza-2. Letters, numbers and hyphens.
External IDexternal_idtext
Your own reference for the copy.

Outputs

account_nametext
The account that owns the site, usually an email
business_emailtext
The business's email
business_nametext
The business the site is for
business_phonetext
The business's phone number
canonical_urltext
The address search engines are sent to
citytext
The business's city
countrytext
The business's country
created_attext
When the site was made (ISO 8601, UTC)
default_domaintext
The site's default address on your Duda domain
editortext
The editor it's built in: SIMPLE, ADVANCED, ADVANCED-2.0 or VIBE
editor_urltext
A link to open the site in the editor
external_idtext
Your own reference for the site; empty if none
first_published_attext
When it was first published (ISO 8601, UTC); empty if never
labelslist
The site's labels
languagetext
The site's main language, such as en
last_published_attext
When it was last published (ISO 8601, UTC); empty if never
modified_attext
When the site last changed (ISO 8601, UTC)
overview_urltext
A link to the site's overview in the dashboard
preview_urltext
A link to preview the site
publish_statustext
PUBLISHED, UNPUBLISHED or NOT_PUBLISHED_YET
seo_descriptiontext
The site's description for search engines
seo_titletext
The site's title for search engines
site_domaintext
The site's own domain, such as example.com; empty if none
site_nametext
The site's name in Duda (its ID), which the other Duda steps take
statetext
The business's state or region
streettext
The business's street address
template_idnumber
The ID of the template it was made from
thumbnail_urltext
A picture of the site
zip_codetext
The business's ZIP or postcode
Example output
{
  "account_name": "owner@example.com",
  "business_email": "business@example.com",
  "business_name": "Example Business",
  "business_phone": "(123) 456-7890",
  "canonical_url": "https://www.example.com/",
  "city": "San Francisco",
  "country": "United States",
  "created_at": "2016-04-01T04:36:54Z",
  "default_domain": "example.multiscreensite.com",
  "editor": "ADVANCED",
  "editor_url": "https://example.com/home/site/6c56394c",
  "external_id": "an-external-reference",
  "first_published_at": "2016-04-03T04:36:54Z",
  "labels": [
    "QA team",
    "priority client"
  ],
  "language": "en",
  "last_published_at": "2016-11-15T22:55:53Z",
  "modified_at": "2016-11-15T22:55:53Z",
  "overview_url": "https://example.com/home/dashboard/overview/6c56394c",
  "preview_url": "https://example.com/link/to/preview",
  "publish_status": "PUBLISHED",
  "seo_description": "A description of the website.",
  "seo_title": "Example Title",
  "site_domain": "example.com",
  "site_name": "6c56394c",
  "state": "CA",
  "street": "1240 Main ST.",
  "template_id": 1027437,
  "thumbnail_url": "https://example.com/link/to/image",
  "zip_code": "94122"
}

Get account

Get a client or team member account's details.

Inputs

Account nameaccount_nametextRequired
The client account's name in Duda, usually the email it was made with.

Outputs

account_nametext
The account's name in Duda, which the other Duda steps take
account_typetext
CUSTOMER for a client, STAFF for a team member
company_nametext
The account holder's company
emailtext
The account holder's email
first_nametext
The account holder's first name
languagetext
The language Duda's screens show them, such as en
last_nametext
The account holder's last name
Example output
{
  "account_name": "uniqueAcctReference",
  "account_type": "CUSTOMER",
  "company_name": "Joann's Agency",
  "email": "example@domain.com",
  "first_name": "Joann",
  "language": "en",
  "last_name": "Smith"
}

Get content library

Get a site's content library: the business's name, logo, phones, emails, address, opening hours, social profiles, texts and images.

Inputs

SitesitetextRequired
The site, or its site name from another Duda step.

Outputs

about_ustext
The site's about-us text
additional_location_countnumber
How many more locations the business has
business_hourslist
When the main location is open
business_nametext
The business's name
categorytext
The kind of business, for Duda's AI assistant
citytext
The main location's city
countrytext
The main location's country
custom_textsobject
The site's own texts, by label
descriptiontext
What the business does, for Duda's AI assistant
emailtext
The main location's first email
emailslist
Every email of the main location
imageslist
The site's images
logo_urltext
A link to the business's logo
overviewtext
The site's overview text
phonetext
The main location's first phone number
phoneslist
Every phone number of the main location
postal_codetext
The main location's postcode
regiontext
The main location's state or region
servicestext
The site's services text
site_nametext
The site's name in Duda (its ID), which the other Duda steps take
social_accountsobject
The location's social profiles, by network, such as facebook
streettext
The main location's street address
Example output
{
  "about_us": "Three generations of bakers.",
  "additional_location_count": 0,
  "business_hours": [
    {
      "close": "17:00",
      "days": [
        "MON",
        "TUE",
        "WED",
        "THU",
        "FRI"
      ],
      "open": "07:30"
    }
  ],
  "business_name": "Example Business",
  "category": "Bakery",
  "city": "San Francisco",
  "country": "US",
  "custom_texts": {
    "tagline": "Baked today"
  },
  "description": "A family bakery making bread and cakes since 1990.",
  "email": "business@example.com",
  "emails": [
    {
      "address": "business@example.com",
      "label": "Orders"
    }
  ],
  "images": [
    {
      "alt": "The bakery from the street",
      "label": "Storefront",
      "url": "https://example.com/path/to/storefront.png"
    }
  ],
  "logo_url": "https://example.com/path/to/logo.png",
  "overview": "Fresh bread every morning.",
  "phone": "(123) 456-7890",
  "phones": [
    {
      "label": "Main",
      "number": "(123) 456-7890"
    }
  ],
  "postal_code": "94122",
  "region": "CA",
  "services": "Bread, cakes and catering.",
  "site_name": "6c56394c",
  "social_accounts": {
    "facebook": "duda"
  },
  "street": "1240 Main ST."
}

Get site

Get a site's details: its business, domain, publish status and dates, and links to edit and preview it.

Inputs

SitesitetextRequired
The site, or its site name from another Duda step.

Outputs

account_nametext
The account that owns the site, usually an email
business_emailtext
The business's email
business_nametext
The business the site is for
business_phonetext
The business's phone number
canonical_urltext
The address search engines are sent to
citytext
The business's city
countrytext
The business's country
created_attext
When the site was made (ISO 8601, UTC)
default_domaintext
The site's default address on your Duda domain
editortext
The editor it's built in: SIMPLE, ADVANCED, ADVANCED-2.0 or VIBE
editor_urltext
A link to open the site in the editor
external_idtext
Your own reference for the site; empty if none
first_published_attext
When it was first published (ISO 8601, UTC); empty if never
labelslist
The site's labels
languagetext
The site's main language, such as en
last_published_attext
When it was last published (ISO 8601, UTC); empty if never
modified_attext
When the site last changed (ISO 8601, UTC)
overview_urltext
A link to the site's overview in the dashboard
preview_urltext
A link to preview the site
publish_statustext
PUBLISHED, UNPUBLISHED or NOT_PUBLISHED_YET
seo_descriptiontext
The site's description for search engines
seo_titletext
The site's title for search engines
site_domaintext
The site's own domain, such as example.com; empty if none
site_nametext
The site's name in Duda (its ID), which the other Duda steps take
statetext
The business's state or region
streettext
The business's street address
template_idnumber
The ID of the template it was made from
thumbnail_urltext
A picture of the site
zip_codetext
The business's ZIP or postcode
Example output
{
  "account_name": "owner@example.com",
  "business_email": "business@example.com",
  "business_name": "Example Business",
  "business_phone": "(123) 456-7890",
  "canonical_url": "https://www.example.com/",
  "city": "San Francisco",
  "country": "United States",
  "created_at": "2016-04-01T04:36:54Z",
  "default_domain": "example.multiscreensite.com",
  "editor": "ADVANCED",
  "editor_url": "https://example.com/home/site/6c56394c",
  "external_id": "an-external-reference",
  "first_published_at": "2016-04-03T04:36:54Z",
  "labels": [
    "QA team",
    "priority client"
  ],
  "language": "en",
  "last_published_at": "2016-11-15T22:55:53Z",
  "modified_at": "2016-11-15T22:55:53Z",
  "overview_url": "https://example.com/home/dashboard/overview/6c56394c",
  "preview_url": "https://example.com/link/to/preview",
  "publish_status": "PUBLISHED",
  "seo_description": "A description of the website.",
  "seo_title": "Example Title",
  "site_domain": "example.com",
  "site_name": "6c56394c",
  "state": "CA",
  "street": "1240 Main ST.",
  "template_id": 1027437,
  "thumbnail_url": "https://example.com/link/to/image",
  "zip_code": "94122"
}

Get site analytics

Get a site's visits, visitors and page views, or its calls, map clicks, email clicks and form submissions, over a period. Leave the dates blank for the last 30 days.

Inputs

SitesitetextRequired
The site, or its site name from another Duda step.
Fromstart_datedate
The first day to count.
Toend_datedate
The last day to count. Defaults to today.
What to countmetricstext
Visits, or what visitors did.One of: traffic (Visits, visitors and page views), activities (Calls, map clicks, email clicks and form submissions). Default: traffic.
Break downbreakdowntext
Split visits by where visitors were or what they used. Leave blank for totals.Only when What to count is Visits, visitors and page views. One of: geo (By country and region), system (By browser and OS).

Outputs

breakdowntext
geo, system, or empty for totals only
click_to_callsnumber
Taps on a call button (activities only)
click_to_emailsnumber
Taps on an email button (activities only)
click_to_mapsnumber
Taps on a map button (activities only)
end_datetext
The last day counted; empty for today
form_submitsnumber
Forms sent (activities only)
metricstext
traffic or activities
page_viewsnumber
Page views; with a breakdown, the rows added up
rowslist
With a breakdown, one row per country and region or browser and OS
site_nametext
The site's name in Duda (its ID), which the other Duda steps take
start_datetext
The first day counted; empty for Duda's default, the last 30 days
visitorsnumber
Unique visitors; with a breakdown, the rows added up
visitsnumber
Visits in the period; with a breakdown, the rows added up
Example output
{
  "breakdown": "geo",
  "click_to_calls": 0,
  "click_to_emails": 0,
  "click_to_maps": 0,
  "end_date": "2016-03-31",
  "form_submits": 0,
  "metrics": "traffic",
  "page_views": 300,
  "rows": [
    {
      "browser": "",
      "country": "US",
      "os": "",
      "page_views": 150,
      "region": "CA",
      "visitors": 50,
      "visits": 100
    },
    {
      "browser": "",
      "country": "Canada",
      "os": "",
      "page_views": 150,
      "region": "Ontario",
      "visitors": 50,
      "visits": 100
    }
  ],
  "site_name": "6c56394c",
  "start_date": "2016-03-01",
  "visitors": 100,
  "visits": 200
}

Grant site access

Let an account work on a site, with what it may do there, such as edit or see stats. It replaces what the account could do on that site.

Inputs

Account nameaccount_nametextRequired
The client account's name in Duda, usually the email it was made with.
SitesitetextRequired
The site, or its site name from another Duda step.
PermissionspermissionslistRequired
What the account may do on the site. Some need others: SEO needs Edit the site.

Outputs

account_nametext
The account's name in Duda, which the other Duda steps take
permissionslist
What the account may now do on the site, as Duda's codes
site_nametext
The site's name in Duda (its ID), which the other Duda steps take
Example output
{
  "account_name": "uniqueAcctReference",
  "permissions": [
    "EDIT",
    "STATS_TAB"
  ],
  "site_name": "6c56394c"
}

List collections

List a site's collections with their fields and rows, or get one collection.

Inputs

SitesitetextRequired
The site, or its site name from another Duda step.
Collectioncollectiontext
Only this collection. Leave blank for all of them.

Outputs

collectionslist
The site's collections
countnumber
How many collections
site_nametext
The site's name in Duda (its ID), which the other Duda steps take
Example output
{
  "collections": [
    {
      "external": false,
      "fields": [
        {
          "name": "date",
          "type": "date_time"
        },
        {
          "name": "entry-price",
          "type": "plain_text"
        },
        {
          "name": "location",
          "type": "plain_text"
        }
      ],
      "name": "events",
      "row_count": 1,
      "rows": [
        {
          "data": {
            "date": "01/10/2019",
            "entry-price": "$50",
            "location": "San Francisco"
          },
          "id": "144",
          "page_item_url": "san-francisco",
          "status": "ACTIVE"
        }
      ]
    }
  ],
  "count": 1,
  "site_name": "6c56394c"
}

List form submissions

List what visitors sent through a site's contact forms, newest first, with every field filled in.

Inputs

SitesitetextRequired
The site, or its site name from another Duda step.
Sincesincedate and time
Only submissions sent from this time on. Leave blank for all of them.
Untiluntildate and time
Only submissions sent before this time.
Campaignutm_campaigntext
Only submissions from this campaign (utm_campaign).

Outputs

countnumber
How many
site_nametext
The site's name in Duda (its ID), which the other Duda steps take
submissionslist
The submissions, newest first
Example output
{
  "count": 1,
  "site_name": "6c56394c",
  "submissions": [
    {
      "fields": {
        "Email": "test@test.com",
        "Message": "test message",
        "Name": "test3",
        "Phone": "123-123-1234"
      },
      "form_title": "Contact Us",
      "site_name": "6c56394c",
      "submitted_at": "2014-05-08T23:12:06Z",
      "text": "Name: test3\nPhone: 123-123-1234\nEmail: test@test.com\nMessage: test message",
      "utm_campaign": ""
    }
  ]
}

List sites

List your Duda sites, newest first, by publish status or the day they were made. Gets one page; to see more, run it again with a higher 'Skip'.

Inputs

Publish statuspublish_statuslist
Only sites in these states. Leave blank for all.One or more of: PUBLISHED, UNPUBLISHED, NOT_PUBLISHED_YET (Not published yet).
Made on or aftercreated_afterdate
Only sites made on or after this day.
Made beforecreated_beforedate
Only sites made before this day.
Ordersorttext
Which sites come first.One of: newest (Newest first), oldest (Oldest first), recently_published (Last published first). Default: newest.
How manylimitnumber
The most to list. Defaults to 50.From 1 to 200.
Skipoffsetnumber
How many sites to skip first, for the next page.At least 0.

Outputs

countnumber
How many are listed
has_moretrue/false
True if there may be more on the next page
offsetnumber
How many sites were skipped before these
siteslist
The sites listed
Example output
{
  "count": 1,
  "has_more": false,
  "offset": 0,
  "sites": [
    {
      "account_name": "owner@example.com",
      "business_email": "business@example.com",
      "business_name": "Example Business",
      "business_phone": "(123) 456-7890",
      "canonical_url": "https://www.example.com/",
      "city": "San Francisco",
      "country": "United States",
      "created_at": "2016-04-01T04:36:54Z",
      "default_domain": "example.multiscreensite.com",
      "editor": "ADVANCED",
      "editor_url": "https://example.com/home/site/6c56394c",
      "external_id": "an-external-reference",
      "first_published_at": "2016-04-03T04:36:54Z",
      "labels": [
        "QA team",
        "priority client"
      ],
      "language": "en",
      "last_published_at": "2016-11-15T22:55:53Z",
      "modified_at": "2016-11-15T22:55:53Z",
      "overview_url": "https://example.com/home/dashboard/overview/6c56394c",
      "preview_url": "https://example.com/link/to/preview",
      "publish_status": "PUBLISHED",
      "seo_description": "A description of the website.",
      "seo_title": "Example Title",
      "site_domain": "example.com",
      "site_name": "6c56394c",
      "state": "CA",
      "street": "1240 Main ST.",
      "template_id": 1027437,
      "thumbnail_url": "https://example.com/link/to/image",
      "zip_code": "94122"
    }
  ]
}

List templates

List the templates a site can be made from: Duda's and your own.

Inputs

Name containsname_containstext
Only templates whose name has these words.
Whosetemplate_typetext
Only Duda's templates or only your own. Leave blank for both.One of: DUDA (Duda's templates), CUSTOM (Your own templates).
Editoreditortext
Only templates for this editor. Leave blank for all.One of: ADVANCED-2.0 (Editor 2.0), ADVANCED (Classic editor), VIBE.
How manylimitnumber
The most to list. Defaults to 100.From 1 to 500.

Outputs

countnumber
How many are listed
templateslist
The templates listed
totalnumber
How many templates matched in all
Example output
{
  "count": 1,
  "templates": [
    {
      "categories": [
        "Business",
        "Events"
      ],
      "editor": "ADVANCED-2.0",
      "has_blog": false,
      "has_store": false,
      "page_count": 1,
      "preview_url": "http://dashboard.russjeffery.com/preview/dm-theme-1026287-en-343",
      "template_alias": "967f2fd827924dd69db4042e708aee6b",
      "template_id": 1005442,
      "template_name": "Consultant Landing Page",
      "template_type": "custom",
      "thumbnail_url": "https://irp-cdn.multiscreensite.com/c1e7738d32ae46538527c1fd4e95a9b9/siteTemplateIcons/4CXbg61CTvKDPTEyC7EQ_Consultant_landing_page_3%20screens.png"
    }
  ],
  "total": 1
}

Publish content library

Put a site's content library changes on its live site.

Inputs

SitesitetextRequired
The site, or its site name from another Duda step.

Outputs

publishedtrue/false
True once the live site has the changes
site_nametext
The site's name in Duda (its ID), which the other Duda steps take
Example output
{
  "published": true,
  "site_name": "6c56394c"
}

Publish site

Put a site live, or put changes made since the last publish live. Publishing starts the site's paid plan on your Duda account.

Inputs

SitesitetextRequired
The site, or its site name from another Duda step.

Outputs

publishedtrue/false
True once it's live
site_nametext
The site's name in Duda (its ID), which the other Duda steps take
Example output
{
  "published": true,
  "site_name": "6c56394c"
}

Unpublish site

Take a site offline. Duda suspends its paid plan; publishing it again brings it back.

Inputs

SitesitetextRequired
The site, or its site name from another Duda step.

Outputs

site_nametext
The site's name in Duda (its ID), which the other Duda steps take
unpublishedtrue/false
True once it's offline
Example output
{
  "site_name": "6c56394c",
  "unpublished": true
}

Update collection row

Change some fields of a row in a site's collection. Fields left out keep their values.

Inputs

SitesitetextRequired
The site, or its site name from another Duda step.
CollectioncollectiontextRequired
The collection, or its name.
Row IDrowtextRequired
The row's ID, from 'Add collection row', 'List collections' or the trigger.
FieldsdataobjectRequired
The row's values, by field. Choose the site and collection to fill them in one by one, or give an object from an earlier step.
Showsstatustext
Where the row shows up. Leave blank for live on a new row, or to keep it as it is on an existing one.One of: ACTIVE (Live (on the site and in the editor)), PREVIEW (Editor only), DRAFT (Draft (in the collection only)).
Publish to the live sitepublishtrue/false
Also publish the collection, so a published site shows the change at once. Off, it waits for the next publish.Default: false.

Outputs

collectiontext
The collection's name
publishedtrue/false
True if the collection was published to the live site
row_idtext
The row's ID
site_nametext
The site's name in Duda (its ID), which the other Duda steps take
Example output
{
  "collection": "events",
  "published": false,
  "row_id": "144",
  "site_name": "6c56394c"
}

Update content library

Change a site's business details, address and texts in its content library. The editor shows them at once; 'Publish content library' puts them live. Fields left blank keep what they have.

Inputs

SitesitetextRequired
The site, or its site name from another Duda step.
Business namebusiness_nametext
The business's name.
Logologo_urltext
A link to the business's logo.
Descriptiondescriptiontext
What the business does, which Duda's AI assistant writes from.
Phonephonetext
The main phone number. It replaces the first number; any others stay.
Emailemailtext
The main email. It replaces the first email; any others stay.
Streetstreettext
The street address.
Citycitytext
The city.
Regionregiontext
The state or region.
Postcodepostal_codetext
The postcode or ZIP code.
Countrycountrytext
The country.
Overviewoverviewtext
The overview text.
Servicesservicestext
The services text.
About usabout_ustext
The about-us text.
Custom textscustom_textsobject
Texts of your own by label, such as {"tagline": "Baked today"}. A label the site already has is replaced.

Outputs

about_ustext
The site's about-us text
additional_location_countnumber
How many more locations the business has
business_hourslist
When the main location is open
business_nametext
The business's name
categorytext
The kind of business, for Duda's AI assistant
citytext
The main location's city
countrytext
The main location's country
custom_textsobject
The site's own texts, by label
descriptiontext
What the business does, for Duda's AI assistant
emailtext
The main location's first email
emailslist
Every email of the main location
imageslist
The site's images
logo_urltext
A link to the business's logo
overviewtext
The site's overview text
phonetext
The main location's first phone number
phoneslist
Every phone number of the main location
postal_codetext
The main location's postcode
regiontext
The main location's state or region
servicestext
The site's services text
site_nametext
The site's name in Duda (its ID), which the other Duda steps take
social_accountsobject
The location's social profiles, by network, such as facebook
streettext
The main location's street address
Example output
{
  "about_us": "Three generations of bakers.",
  "additional_location_count": 0,
  "business_hours": [
    {
      "close": "17:00",
      "days": [
        "MON",
        "TUE",
        "WED",
        "THU",
        "FRI"
      ],
      "open": "07:30"
    }
  ],
  "business_name": "Example Business",
  "category": "Bakery",
  "city": "San Francisco",
  "country": "US",
  "custom_texts": {
    "tagline": "Baked today"
  },
  "description": "A family bakery making bread and cakes since 1990.",
  "email": "business@example.com",
  "emails": [
    {
      "address": "business@example.com",
      "label": "Orders"
    }
  ],
  "images": [
    {
      "alt": "The bakery from the street",
      "label": "Storefront",
      "url": "https://example.com/path/to/storefront.png"
    }
  ],
  "logo_url": "https://example.com/path/to/logo.png",
  "overview": "Fresh bread every morning.",
  "phone": "(123) 456-7890",
  "phones": [
    {
      "label": "Main",
      "number": "(123) 456-7890"
    }
  ],
  "postal_code": "94122",
  "region": "CA",
  "services": "Bread, cakes and catering.",
  "site_name": "6c56394c",
  "social_accounts": {
    "facebook": "duda"
  },
  "street": "1240 Main ST."
}

Update site

Change a site's domain, address, references, SEO settings, favicon or Google tags. Fields left blank keep what the site has.

Inputs

SitesitetextRequired
The site, or its site name from another Duda step.
Domainsite_domaintext
The site's own domain, such as www.example.com.
Address prefixdefault_domain_prefixtext
A new first part for its default address. Letters, numbers and hyphens.
External IDexternal_idtext
Your own reference for it.
SEO titleseo_titletext
Its title for search engines.
SEO descriptionseo_descriptiontext
Its description for search engines.
Search enginessearch_enginestext
Whether search engines may list it. Leave blank to keep it as it is.One of: index (Let search engines list it), noindex (Hide it from search engines).
Faviconfavicon_urltext
A link to its new favicon.
Google tag IDsgoogle_tag_idslist
Up to 10 Google tag IDs, such as G-XXXXXXX or GTM-XXXXXX. They replace the ones it has.

Outputs

account_nametext
The account that owns the site, usually an email
business_emailtext
The business's email
business_nametext
The business the site is for
business_phonetext
The business's phone number
canonical_urltext
The address search engines are sent to
citytext
The business's city
countrytext
The business's country
created_attext
When the site was made (ISO 8601, UTC)
default_domaintext
The site's default address on your Duda domain
editortext
The editor it's built in: SIMPLE, ADVANCED, ADVANCED-2.0 or VIBE
editor_urltext
A link to open the site in the editor
external_idtext
Your own reference for the site; empty if none
first_published_attext
When it was first published (ISO 8601, UTC); empty if never
labelslist
The site's labels
languagetext
The site's main language, such as en
last_published_attext
When it was last published (ISO 8601, UTC); empty if never
modified_attext
When the site last changed (ISO 8601, UTC)
overview_urltext
A link to the site's overview in the dashboard
preview_urltext
A link to preview the site
publish_statustext
PUBLISHED, UNPUBLISHED or NOT_PUBLISHED_YET
seo_descriptiontext
The site's description for search engines
seo_titletext
The site's title for search engines
site_domaintext
The site's own domain, such as example.com; empty if none
site_nametext
The site's name in Duda (its ID), which the other Duda steps take
statetext
The business's state or region
streettext
The business's street address
template_idnumber
The ID of the template it was made from
thumbnail_urltext
A picture of the site
zip_codetext
The business's ZIP or postcode
Example output
{
  "account_name": "owner@example.com",
  "business_email": "business@example.com",
  "business_name": "Example Business",
  "business_phone": "(123) 456-7890",
  "canonical_url": "https://www.example.com/",
  "city": "San Francisco",
  "country": "United States",
  "created_at": "2016-04-01T04:36:54Z",
  "default_domain": "example.multiscreensite.com",
  "editor": "ADVANCED",
  "editor_url": "https://example.com/home/site/6c56394c",
  "external_id": "an-external-reference",
  "first_published_at": "2016-04-03T04:36:54Z",
  "labels": [
    "QA team",
    "priority client"
  ],
  "language": "en",
  "last_published_at": "2016-11-15T22:55:53Z",
  "modified_at": "2016-11-15T22:55:53Z",
  "overview_url": "https://example.com/home/dashboard/overview/6c56394c",
  "preview_url": "https://example.com/link/to/preview",
  "publish_status": "PUBLISHED",
  "seo_description": "A description of the website.",
  "seo_title": "Example Title",
  "site_domain": "example.com",
  "site_name": "6c56394c",
  "state": "CA",
  "street": "1240 Main ST.",
  "template_id": 1027437,
  "thumbnail_url": "https://example.com/link/to/image",
  "zip_code": "94122"
}

On this page