Specify the characteristics of the new ACS user by including the corresponding parameters in the request body. Also, include the acs_system_id
of the access control system to which you want to add the new ACS user. In addition, you can specify the acs_access_group_ids
of the access groups to which you want to add the new ACS user, as well as a user_identity_id
if you want to associate the new ACS user with a user identity .
Python cURL (bash) JavaScript Ruby PHP C# Java Go
Copy seam . acs . users . create (
acs_system_id = "11111111-1111-1111-1111-111111111111" ,
user_identity_id = "22222222-2222-2222-2222-222222222222" ,
acs_access_group_ids = [ "44444444-4444-4444-4444-444444444444" ],
full_name = "Jane Doe" ,
email_address = "jane@example.com" ,
phone_number = "+15555550100" ,
access_schedule = {
"starts_at" : "2024-03-01T10:40:00Z" ,
"ends_at" : "2024-03-04T10:40:00Z"
}
)
Copy curl -X 'POST' \
'https://connect.getseam.com/acs/users/create' \
-H 'accept: application/json' \
-H "Authorization: Bearer ${API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
"acs_system_id": "11111111-1111-1111-1111-111111111111",
"user_identity_id": "22222222-2222-2222-2222-222222222222",
"acs_access_group_ids": ["44444444-4444-4444-4444-444444444444"],
"full_name": "Jane Doe",
"email_address": "jane@example.com",
"phone_number": "+15555550100",
"access_schedule": {
"starts_at": "2024-03-01T10:40:00Z",
"ends_at": "2024-03-04T10:40:00Z"
}
}'
Copy await seam . acs . users .create ({
acs_system_id : "11111111-1111-1111-1111-111111111111" ,
user_identity_id : "22222222-2222-2222-2222-222222222222" ,
acs_access_group_ids : [ "44444444-4444-4444-4444-444444444444" ] ,
full_name : "Jane Doe" ,
email_address : "jane@example.com" ,
phone_number : "+15555550100" ,
access_schedule : {
"starts_at" : "2024-03-01T10:40:00Z" ,
"ends_at" : "2024-03-04T10:40:00Z"
}
});
Copy $seam -> acs -> users -> create (
acs_system_id : "11111111-1111-1111-1111-111111111111" ,
user_identity_id : "22222222-2222-2222-2222-222222222222" ,
acs_access_group_ids : [ "44444444-4444-4444-4444-444444444444" ] ,
full_name : "Jane Doe" ,
email_address : "jane@example.com" ,
phone_number : "+15555550100" ,
access_schedule : array (
"starts_at" => "2024-03-01T10:40:00Z" ,
"ends_at" => "2024-03-04T10:40:00Z"
)
) ;
Copy seam . UsersAcs . Create (
acsSystemId : "11111111-1111-1111-1111-111111111111" ,
userIdentityId : "22222222-2222-2222-2222-222222222222" ,
acsAccessGroupIds : new List < string >( new string [] { "44444444-4444-4444-4444-444444444444" }) ,
fullName : "Jane Doe" ,
emailAddress : "jane@example.com" ,
phoneNumber : "+15555550100" ,
accessSchedule : new Dictionary < string , string >()
{
{ "starts_at" , "2024-03-01T10:40:00Z" } ,
{ "ends_at" , "2024-03-04T10:40:00Z" }
}
);
Copy startsAt, err := time. Parse (time.RFC3339, "2024-03-01T10:40:00Z" )
endsAt, err := time. Parse (time.RFC3339, "2024-03-04T10:40:00Z" )
if err != nil {
return err
}
acs_user, uErr := client.Acs.Users. Create (
context. Background (), & acs . UsersCreateRequest {
AcsSystemId: "11111111-1111-1111-1111-111111111111" ,
UserIdentityId: api. String ( "22222222-2222-2222-2222-222222222222" ),
AcsAccessGroupIds: [] string { "44444444-4444-4444-4444-444444444444" },
FullName: api. String ( "Jane Doe" ),
EmailAddress: api. String ( "jane@example.com" ),
PhoneNumber: api. String ( "+15555550100" ),
AccessSchedule: & acs . UsersCreateRequestAccessSchedule {
StartsAt: startsAt,
EndsAt: endsAt,
},
},
)
Python cURL (bash) JavaScript Ruby PHP C# Java Go
Copy AcsUser(
acs_user_id='33333333-3333-3333-3333-333333333333',
display_name='Jane Doe',
full_name='Jane Doe',
email='jane@example.com',
email_address='jane@example.com',
phone_number='+15555550100',
acs_system_id='11111111-1111-1111-1111-111111111111',
workspace_id='00000000-0000-0000-0000-000000000000',
created_at='2024-04-05T07:14:28.531Z',
is_suspended=False,
access_schedule={
starts_at='2024-03-01T10:40:00.000Z',
ends_at='2024-03-04T10:40:00.000Z'
},
user_identity_id='22222222-2222-2222-2222-222222222222'
)
Copy {
"acs_user" : {
"acs_user_id" : "33333333-3333-3333-3333-333333333333" ,
"display_name" : "Jane Doe" ,
"full_name" : "Jane Doe" ,
"email" : "jane@example.com" ,
"email_address" : "jane@example.com" ,
"phone_number" : "+15555550100" ,
"acs_system_id" : "11111111-1111-1111-1111-111111111111" ,
"workspace_id" : "00000000-0000-0000-0000-000000000000" ,
"created_at" : "2024-04-05T07:14:28.531Z" ,
"is_suspended" : false ,
"access_schedule" : {
"starts_at" : "2024-03-01T10:40:00.000Z" ,
"ends_at" : "2024-03-04T10:40:00.000Z"
} ,
"user_identity_id" : "22222222-2222-2222-2222-222222222222"
} ,
"ok" : true
}
Copy {
acs_user_id : ' 33333333-3333-3333-3333-333333333333 ' ,
display_name : 'Jane Doe' ,
full_name : 'Jane Doe' ,
email : 'jane@example.com' ,
email_address : 'jane@example.com' ,
phone_number : '+ 15555550100 ' ,
acs_system_id : ' 11111111-1111-1111-1111-111111111111 ' ,
workspace_id : ' 00000000-0000-0000-0000-000000000000 ' ,
created_at : ' 2024-04-05 T 07 : 28 : 06.012 Z' ,
is_suspended : false ,
access_schedule : {
starts_at : ' 2024-03-01 T 10 : 40 : 00.000 Z' ,
ends_at : ' 2024-03-04 T 10 : 40 : 00.000 Z'
} ,
user_identity_id : ' 22222222-2222-2222-2222-222222222222 '
}
Copy {
"acs_user_id" : "33333333-3333-3333-3333-333333333333" ,
"display_name" : "Jane Doe" ,
"full_name" : "Jane Doe" ,
"email" : "jane@example.com" ,
"email_address" : "jane@example.com" ,
"phone_number" : "+15555550100" ,
"acs_system_id" : "11111111-1111-1111-1111-111111111111" ,
"workspace_id" : "00000000-0000-0000-0000-000000000000" ,
"created_at" : "2024-04-05T07:14:28.531Z" ,
"is_suspended" : false ,
"access_schedule" : {
"starts_at" : "2024-03-01T10:40:00.000Z" ,
"ends_at" : "2024-03-04T10:40:00.000Z"
} ,
"user_identity_id" : "22222222-2222-2222-2222-222222222222"
}
Copy {
"acs_user_id" : "33333333-3333-3333-3333-333333333333" ,
"display_name" : "Jane Doe" ,
"full_name" : "Jane Doe" ,
"email" : "jane@example.com" ,
"email_address" : "jane@example.com" ,
"phone_number" : "+15555550100" ,
"acs_system_id" : "11111111-1111-1111-1111-111111111111" ,
"workspace_id" : "00000000-0000-0000-0000-000000000000" ,
"created_at" : "2024-04-05T07:14:28.531Z" ,
"is_suspended" : false ,
"access_schedule" : {
"starts_at" : "2024-03-01T10:40:00.000Z" ,
"ends_at" : "2024-03-04T10:40:00.000Z"
} ,
"user_identity_id" : "22222222-2222-2222-2222-222222222222"
}
Copy {
"acs_user" : {
"acs_user_id" : "33333333-3333-3333-3333-333333333333" ,
"display_name" : "Jane Doe" ,
"full_name" : "Jane Doe" ,
"email" : "jane@example.com" ,
"email_address" : "jane@example.com" ,
"phone_number" : "+15555550100" ,
"acs_system_id" : "11111111-1111-1111-1111-111111111111" ,
"workspace_id" : "00000000-0000-0000-0000-000000000000" ,
"created_at" : "2024-04-05T07:57:05.323Z" ,
"is_suspended" : false ,
"access_schedule" : {
"starts_at" : "2024-03-01T10:40:00.000Z" ,
"ends_at" : "2024-03-04T10:40:00.000Z"
} ,
"user_identity_id" : "22222222-2222-2222-2222-222222222222"
} ,
"ok" : true
}