# Create new web audit

POST /v2/web-audits

Endpoint: POST /web-audits
Security: API_Key

## Request fields (application/json):

  - `domainId` (integer, required)

  - `filters` (object)

  - `filters.exclude` (array, required)

  - `filters.include` (array, required)

  - `filters.include.includeLimit` (integer, required)

  - `filters.include.value` (string, required)

  - `frequency` (string)

  - `limit` (integer, required)

  - `name` (string, required)

  - `nextRun` (string)

  - `options` (object)

  - `options.adobeAuditor` (boolean)

  - `options.blockThirdPartyCookies` (boolean)

  - `options.browserHeight` (integer)

  - `options.browserWidth` (integer)

  - `options.customHttpHeaders` (array)

  - `options.customHttpHeaders.groupId` (integer, required)

  - `options.customHttpHeaders.isApplyToAll` (boolean, required)

  - `options.customProxy` (string)

  - `options.discoverSitemap` (boolean)

  - `options.fireTags` (boolean, required)

  - `options.gpcEnabled` (boolean)

  - `options.loadFlash` (boolean, required)

  - `options.location` (string, required)

  - `options.remoteFileMapConfig` (array)

  - `options.remoteFileMapConfig.createdAt` (string)

  - `options.remoteFileMapConfig.createdBy` (integer)

  - `options.remoteFileMapConfig.fileId` (integer)

  - `options.remoteFileMapConfig.fileUrl` (string)

  - `options.remoteFileMapConfig.id` (integer)

  - `options.remoteFileMapConfig.matchType` (string, required)
    Enum: "[equals", "regex]"

  - `options.remoteFileMapConfig.matchValue` (string, required)

  - `options.remoteFileMapConfig.updatedAt` (string)

  - `options.remoteFileMapConfig.updatedBy` (integer)

  - `options.requestRate` (integer, required)

  - `options.sameUrlRunId` (number)

  - `options.stripQueryString` (boolean, required)

  - `options.userAgent` (string, required)

  - `options.vpnEnabled` (boolean)

  - `options.webHookUrl` (string)

  - `recipients` (array, required)

  - `schedule` (object)

  - `schedule.dtStart` (object, required)

  - `schedule.dtStart.centuryOfEra` (integer, required)

  - `schedule.dtStart.chronology` (object, required)

  - `schedule.dtStart.chronology.zone` (object, required)

  - `schedule.dtStart.chronology.zone.fixed` (boolean, required)

  - `schedule.dtStart.dayOfMonth` (integer, required)

  - `schedule.dtStart.dayOfWeek` (integer, required)

  - `schedule.dtStart.dayOfYear` (integer, required)

  - `schedule.dtStart.era` (integer, required)

  - `schedule.dtStart.fieldTypes` (array, required)

  - `schedule.dtStart.fieldTypes.durationType` (object, required)

  - `schedule.dtStart.fieldTypes.rangeDurationType` (object, required)

  - `schedule.dtStart.fields` (array, required)

  - `schedule.dtStart.fields.durationField` (object, required)

  - `schedule.dtStart.fields.durationField.precise` (boolean, required)

  - `schedule.dtStart.fields.durationField.supported` (boolean, required)

  - `schedule.dtStart.fields.durationField.type` (object, required)

  - `schedule.dtStart.fields.durationField.unitMillis` (integer, required)

  - `schedule.dtStart.fields.leapDurationField` (object, required)

  - `schedule.dtStart.fields.lenient` (boolean, required)

  - `schedule.dtStart.fields.maximumValue` (integer, required)

  - `schedule.dtStart.fields.minimumValue` (integer, required)

  - `schedule.dtStart.fields.rangeDurationField` (object, required)

  - `schedule.dtStart.hourOfDay` (integer, required)

  - `schedule.dtStart.millisOfDay` (integer, required)

  - `schedule.dtStart.millisOfSecond` (integer, required)

  - `schedule.dtStart.minuteOfHour` (integer, required)

  - `schedule.dtStart.monthOfYear` (integer, required)

  - `schedule.dtStart.secondOfMinute` (integer, required)

  - `schedule.dtStart.values` (array, required)

  - `schedule.dtStart.weekOfWeekyear` (integer, required)

  - `schedule.dtStart.weekyear` (integer, required)

  - `schedule.dtStart.year` (integer, required)

  - `schedule.dtStart.yearOfCentury` (integer, required)

  - `schedule.dtStart.yearOfEra` (integer, required)

  - `schedule.isPaused` (boolean, required)

  - `schedule.recurrenceRule` (string, required)

  - `schedule.tzId` (string, required)

  - `startingUrls` (array, required)

## Response 201 fields (application/json):

  - `created` (string, required)

  - `domainId` (integer, required)

  - `filters` (object)

  - `filters.exclude` (array, required)

  - `filters.include` (array, required)

  - `filters.include.includeLimit` (integer, required)

  - `filters.include.value` (string, required)

  - `folderId` (integer, required)

  - `frequency` (string)

  - `id` (integer, required)

  - `labels` (array, required)

  - `labels.name` (string, required)

  - `lastRun` (string)

  - `lastUpdated` (string, required)

  - `limit` (integer, required)

  - `nextRun` (string)

  - `options` (object)

  - `options.adobeAuditor` (boolean)

  - `options.blockThirdPartyCookies` (boolean)

  - `options.browserHeight` (integer)

  - `options.browserWidth` (integer)

  - `options.customHttpHeaders` (array)

  - `options.customHttpHeaders.groupId` (integer, required)

  - `options.customHttpHeaders.isApplyToAll` (boolean, required)

  - `options.customProxy` (string)

  - `options.discoverSitemap` (boolean)

  - `options.fireTags` (boolean, required)

  - `options.gpcEnabled` (boolean)

  - `options.loadFlash` (boolean, required)

  - `options.location` (string, required)

  - `options.remoteFileMapConfig` (array)

  - `options.remoteFileMapConfig.createdAt` (string)

  - `options.remoteFileMapConfig.createdBy` (integer)

  - `options.remoteFileMapConfig.fileId` (integer)

  - `options.remoteFileMapConfig.fileUrl` (string)

  - `options.remoteFileMapConfig.matchType` (string, required)
    Enum: "[equals", "regex]"

  - `options.remoteFileMapConfig.matchValue` (string, required)

  - `options.remoteFileMapConfig.updatedAt` (string)

  - `options.remoteFileMapConfig.updatedBy` (integer)

  - `options.requestRate` (integer, required)

  - `options.sameUrlRunId` (number)

  - `options.stripQueryString` (boolean, required)

  - `options.userAgent` (string, required)

  - `options.vpnEnabled` (boolean)

  - `options.webHookUrl` (string)

  - `ownerId` (integer, required)

  - `queued` (boolean, required)

  - `recipients` (array, required)

  - `rules` (array)

  - `rules.accountId` (integer, required)

  - `rules.checkTimes` (integer, required)

  - `rules.matchAllFilters` (boolean, required)

  - `runs` (array, required)

  - `runs.completed` (string)

  - `runs.score` (integer)
    Deprecated. Use /v3/web-audits/{auditId}/runs/{runId}/scores instead

  - `runs.silentMode` (boolean, required)

  - `runs.started` (string)

  - `runs.supportedFeatures` (array)
    Example: "[TagLoadtimeReport, ConsoleLogsReport]"

  - `runs.taggedUrl` (integer, required)

  - `runs.totalUrl` (integer, required)

  - `runs.userId` (integer, required)

  - `runs.webAuditId` (integer, required)

  - `schedule` (boolean)

  - `screenshot` (string)

  - `startingUrls` (array, required)

  - `taggingPlans` (array)

  - `webAuditRunning` (number)


## Response 401 fields

## Response 404 fields