Websites - Create Website

Service:
Power Platform API
API Version:
2024-10-01

Create a Power Pages website.
Trigger the creation of a new website.

POST https://api.powerplatform.com/powerpages/environments/{environmentId}/websites?api-version=2024-10-01

URI Parameters

Name In Required Type Description
environmentId
 path True

string

The environment ID.
api-version
 query True

string

The API version.

Request Body

Name Required Type Description
dataverseOrganizationId True

string (uuid)

Dataverse organization's unique identifier (ID)
name True

string

Name of the website
selectedBaseLanguage True

integer (int32)

Language ID - https://go.microsoft.com/fwlink/?linkid=2208135
subdomain True

string

Subdomain for the website URL
templateName True

WebsiteTemplateName

Website template name. Supported templates, their display names, and template type:

Template Display Name Template Type
StarterLayout1 Starter Layout 1 Power Pages
StarterLayout2 Starter Layout 2 Power Pages
StarterLayout3 Starter Layout 3 Power Pages
StarterLayout4 Starter Layout 4 Power Pages
StarterLayout5 Starter Layout 5 Power Pages
BlankPage Blank Page Power Pages
BookMeetings Schedule and Manage Meetings Power Pages
DefaultPortalTemplate Starter Layout 1 Power Pages
PowerPortals_ProgramRegistration Program Registration Power Pages
PowerPortals_BookMeeting Schedule and Manage Meetings Power Pages
FAQ Frequently Asked Questions Power Pages
ProgramRegistration Program Registration Power Pages
BuildingPermit Application Processing Power Pages
Community Community Dynamics 365
EventPortal Event Portal Dynamics 365
CustomerSelfServicePortal Customer Self Service Portal Dynamics 365
EmployeeSelfServicePortal Employee Self Service Portal Dynamics 365
PartnerPortal Partner Portal Dynamics 365
CustomerPortal Customer Portal Dynamics 365
FieldService Field Service Dynamics 365
websiteRecordId

string

Dataverse record unique identifier (ID) of the website

Responses

Name Type Description
202 Accepted

Accepted

Headers

Operation-Location: string
400 Bad Request

ErrorMessage

Bad Request
401 Unauthorized

ErrorMessage

Unauthorized
404 Not Found

ErrorMessage

Not Found

Security

oauth2

Microsoft Entra ID OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize?resource=https://api.powerplatform.com

Scopes

Name Description
.default .default

Definitions

Name Description
Details
Error
ErrorMessage
NewWebsiteRequest
WebsiteTemplateName

Website template name. Supported templates, their display names, and template type:

Template Display Name Template Type
StarterLayout1 Starter Layout 1 Power Pages
StarterLayout2 Starter Layout 2 Power Pages
StarterLayout3 Starter Layout 3 Power Pages
StarterLayout4 Starter Layout 4 Power Pages
StarterLayout5 Starter Layout 5 Power Pages
BlankPage Blank Page Power Pages
BookMeetings Schedule and Manage Meetings Power Pages
DefaultPortalTemplate Starter Layout 1 Power Pages
PowerPortals_ProgramRegistration Program Registration Power Pages
PowerPortals_BookMeeting Schedule and Manage Meetings Power Pages
FAQ Frequently Asked Questions Power Pages
ProgramRegistration Program Registration Power Pages
BuildingPermit Application Processing Power Pages
Community Community Dynamics 365
EventPortal Event Portal Dynamics 365
CustomerSelfServicePortal Customer Self Service Portal Dynamics 365
EmployeeSelfServicePortal Employee Self Service Portal Dynamics 365
PartnerPortal Partner Portal Dynamics 365
CustomerPortal Customer Portal Dynamics 365
FieldService Field Service Dynamics 365

Details

Object
Name Type Description
code

string

Error code
message

string

Error message
target

string

Target parameter

Error

Object
Name Type Description
code

string

Error code
details

Details[]

message

string

Error message
target

string

Target parameter

ErrorMessage

Object
Name Type Description
error

Error

NewWebsiteRequest

Object
Name Type Description
dataverseOrganizationId

string (uuid)

Dataverse organization's unique identifier (ID)
name

string

Name of the website
selectedBaseLanguage

integer (int32)

Language ID - https://go.microsoft.com/fwlink/?linkid=2208135
subdomain

string

Subdomain for the website URL
templateName

WebsiteTemplateName

Website template name. Supported templates, their display names, and template type:

Template Display Name Template Type
StarterLayout1 Starter Layout 1 Power Pages
StarterLayout2 Starter Layout 2 Power Pages
StarterLayout3 Starter Layout 3 Power Pages
StarterLayout4 Starter Layout 4 Power Pages
StarterLayout5 Starter Layout 5 Power Pages
BlankPage Blank Page Power Pages
BookMeetings Schedule and Manage Meetings Power Pages
DefaultPortalTemplate Starter Layout 1 Power Pages
PowerPortals_ProgramRegistration Program Registration Power Pages
PowerPortals_BookMeeting Schedule and Manage Meetings Power Pages
FAQ Frequently Asked Questions Power Pages
ProgramRegistration Program Registration Power Pages
BuildingPermit Application Processing Power Pages
Community Community Dynamics 365
EventPortal Event Portal Dynamics 365
CustomerSelfServicePortal Customer Self Service Portal Dynamics 365
EmployeeSelfServicePortal Employee Self Service Portal Dynamics 365
PartnerPortal Partner Portal Dynamics 365
CustomerPortal Customer Portal Dynamics 365
FieldService Field Service Dynamics 365
websiteRecordId

string

Dataverse record unique identifier (ID) of the website

WebsiteTemplateName

Enumeration

Website template name. Supported templates, their display names, and template type:

Template Display Name Template Type
StarterLayout1 Starter Layout 1 Power Pages
StarterLayout2 Starter Layout 2 Power Pages
StarterLayout3 Starter Layout 3 Power Pages
StarterLayout4 Starter Layout 4 Power Pages
StarterLayout5 Starter Layout 5 Power Pages
BlankPage Blank Page Power Pages
BookMeetings Schedule and Manage Meetings Power Pages
DefaultPortalTemplate Starter Layout 1 Power Pages
PowerPortals_ProgramRegistration Program Registration Power Pages
PowerPortals_BookMeeting Schedule and Manage Meetings Power Pages
FAQ Frequently Asked Questions Power Pages
ProgramRegistration Program Registration Power Pages
BuildingPermit Application Processing Power Pages
Community Community Dynamics 365
EventPortal Event Portal Dynamics 365
CustomerSelfServicePortal Customer Self Service Portal Dynamics 365
EmployeeSelfServicePortal Employee Self Service Portal Dynamics 365
PartnerPortal Partner Portal Dynamics 365
CustomerPortal Customer Portal Dynamics 365
FieldService Field Service Dynamics 365
Value Description
StarterLayout1
StarterLayout2
StarterLayout3
StarterLayout4
StarterLayout5
BlankPage
BookMeetings
FAQ
ProgramRegistration
BuildingPermit
Community
EventPortal
CustomerSelfServicePortal
EmployeeSelfServicePortal
PartnerPortal
CustomerPortal
FieldService
DefaultPortalTemplate
PowerPortals_ProgramRegistration
PowerPortals_BookMeeting