| POST | /users/prospect | Create a Prospect |
|---|
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| XForwardedFor | header | string | No | IP address of the end user |
| ApiKey | query | string | Yes | Api Key - grants access to resources |
| StoreId | query | integer | Yes | ClubReady Club ID (StoreID internally) |
| FirstName | query | string | Yes | First Name |
| LastName | query | string | Yes | Last Name |
| query | string | Yes | Email Address | |
| Gender | query | string | No | Gender (Format:'M'|'F') |
| Address | query | string | No | Address |
| City | query | string | No | City |
| State | query | string | No | |
| Zip | query | string | No | |
| Phone | query | string | No | Home phone |
| WorkPhone | query | string | No | Work phone |
| DateOfBirth | query | date | No | Date of Birth (Format:YYYY-MM-DD) |
| CellPhone | query | string | No | Cell phone |
| AddPackageId | query | integer | No | Specify a Package to apply to the new prospect |
| ProspectTypeId | query | integer | No | Specify a specific Prospect Type for the new prospect |
| ReferralTypeId | query | integer | No | Specify a specific Referral Type for the new prospect |
| SendEmail | query | boolean | Yes | Send a Welcome email to the new prospect (Format:true|false) |
| EmailTemplateId | query | integer | No | Only used if SendEmail = True |
| Coupon | query | string | No | |
| Note | query | string | No | Add an internal note for the new prospect |
| ExternalId | query | string | No | Unique ID for the user from your system. We store internally as ExternalUserId |
| ReferredBy | query | integer | No | User ID of existing user who referred them. |
| AssignToId | query | integer | No | ClubReady UserId of staff to assign new member to. |
| AssignToMethod | query | integer | No | Who should be assigned to this lead? 0 = Default lead assignments, 1 = When passing in a ReferredBy user, assign the new Lead to that referring user's Staff assignment. |
| Username | query | string | No | Username needs to be between 4 and 255 characters |
| EmergencyContactName | query | string | No | Emergency contact name |
| EmergencyContactPhone | query | string | No | Emergency contact phone number |
| EmergencyContactType | query | string | No | Emergency contact relationship |
| EmailOptOut | query | boolean | No | Set a prospect's email opt out status (Format:true|false) |
| NonPromotionalSmsOptedIn | query | boolean | No | Set a prospect's NonPromotionalSmsOptedIn status (Format:true|false) |
| PromotionalSmsOptedIn | query | boolean | No | Set a prospect's NonPromotionalSmsOptedIn status (Format:true|false) |
| RestrictedId | body | int? | No | |
| RestrictedResourceType | body | RestrictedResourceType | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| FirstName | form | string | No | |
| LastName | form | string | No | |
| Address | form | string | No | |
| City | form | string | No | |
| State | form | string | No | |
| Zip | form | string | No | |
| form | string | No | ||
| Gender | form | string | No | |
| AddPackageId | form | int? | No | |
| ProspectTypeId | form | int? | No | |
| ReferralTypeId | form | int? | No | |
| SendEmail | form | bool | No | |
| Phone | form | string | No | |
| WorkPhone | form | string | No | |
| DateOfBirth | form | DateTime? | No | |
| CellPhone | form | string | No | |
| Coupon | form | string | No | |
| Note | form | string | No | |
| EmailTemplateId | form | int? | No | |
| ExternalId | form | string | No | |
| ReferredBy | form | int? | No | |
| AssignToId | form | int? | No | |
| AssignToMethod | form | int | No | |
| ContactedHow | form | int? | No | |
| Username | form | string | No | |
| EmergencyContactName | form | string | No | |
| EmergencyContactPhone | form | string | No | |
| EmergencyContactType | form | string | No | |
| EmailOptOut | form | bool | No | |
| NonPromotionalSmsOptedIn | form | bool? | No | |
| PromotionalSmsOptedIn | form | bool? | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| ApiKey | form | string | No | |
| StoreId | form | int? | No | |
| ChainId | form | int? | No |
| Store | |
| Chain | |
| User | |
| Undefined |
To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /users/prospect HTTP/1.1
Host: www.clubready.com
Accept: application/xml
Content-Type: application/xml
Content-Length: length
<CreateProspectRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Web.Api.Members.Model">
<ApiKey xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api">String</ApiKey>
<ChainId xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api">0</ChainId>
<StoreId xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api">0</StoreId>
<AddPackageId xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">0</AddPackageId>
<Address xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">String</Address>
<AssignToId xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">0</AssignToId>
<AssignToMethod xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">0</AssignToMethod>
<CellPhone xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">String</CellPhone>
<City xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">String</City>
<ContactedHow xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">0</ContactedHow>
<Coupon xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">String</Coupon>
<DateOfBirth xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">0001-01-01T00:00:00</DateOfBirth>
<Email xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">String</Email>
<EmailOptOut xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">false</EmailOptOut>
<EmailTemplateId xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">0</EmailTemplateId>
<EmergencyContactName xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">String</EmergencyContactName>
<EmergencyContactPhone xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">String</EmergencyContactPhone>
<EmergencyContactType xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">String</EmergencyContactType>
<ExternalId xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">String</ExternalId>
<FirstName xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">String</FirstName>
<Gender xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">String</Gender>
<LastName xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">String</LastName>
<NonPromotionalSmsOptedIn xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">false</NonPromotionalSmsOptedIn>
<Note xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">String</Note>
<Phone xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">String</Phone>
<PromotionalSmsOptedIn xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">false</PromotionalSmsOptedIn>
<ProspectTypeId xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">0</ProspectTypeId>
<ReferralTypeId xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">0</ReferralTypeId>
<ReferredBy xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">0</ReferredBy>
<SendEmail xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">false</SendEmail>
<State xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">String</State>
<Username xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">String</Username>
<WorkPhone xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">String</WorkPhone>
<Zip xmlns="http://schemas.datacontract.org/2004/07/ClubReady.Core.Api.Models">String</Zip>
<XForwardedFor>String</XForwardedFor>
</CreateProspectRequest>
HTTP/1.1 200 OK Content-Type: application/xml Content-Length: length <z:anyType xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:z="http://schemas.microsoft.com/2003/10/Serialization/" />