Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Create AD Object activity

The Create AD Object activity creates an object in Windows Active Directory.

This activity fails if it finds an existing object with matching input variables.

To access this activity in the Workflow Editor, select the Custom tab, and then navigate to Custom Activities > Active Directory.

Note: This activity replaces an AD activity by the same name available in prior releases. If you have a workflow that uses the deprecated activity, your workflow will continue to work normally after upgrading to Instanbul. However, all new workflows must use the custom version of this activity, which was built with the PowerShell activity designer.

Input variables

VariableDescription
DomainControllerIP address of the domain controller machine.
TypeThe object type to create: user, group, or computer.
OUThe organizational unit to which this object belongs.
ObjectNameThe sAMAccountName of the Active Directory object. Object name is also used for the name attribute in Active Directory. This behavior is available in ActiveDirectory.psm1. Whatever is passed as the Object name becomes both the samAccountName and the name of the new user in Active Directory.
ObjectDataA JSON object containing Active Directory property names and their corresponding values. For example:
{ 
  "givenName" : "John",
  "SN" : "Doe",
  "title" : "Sr. Account Specialist",
  "allowLogin" : true
}
This example sets the first name \(givenName\), last name \(SN\), and title on the Active Directory user account and allows that user to log in \(allowLogin\). This field allows expression evaluation via the $\{\} variable substitution syntax.

Output variables

VariableDescription
resultEither success or failure.
errorMessageThe executionResult.errorMessages from the Activity designer parsing sources.

Conditions

ConditionDescription
SuccessA Windows Active Directory object was created successfully.
FailureAn error occurred while attempting to create the AD object. Additional details may be available in the workflow log.

Parent Topic:Active Directory activity pack