createCrmAccount

createCrmAccount_1

Request

Bodyapplication/jsonrequired

idinteger, (int32)

Identifier of the object to modify or delete

Default:""

namestring, [ 0 .. 255 ] charactersrequired

Account name

Default:""

Example:"ACME Corp"

legalNamestring, [ 0 .. 255 ] characters

Legal registered name

Default:""

Example:"ACME Corporation S.L."

cifstring, [ 0 .. 40 ] characters

Tax identification number

Default:""

Example:"B12345678"

codestring, [ 0 .. 40 ] characters

Account code

Default:""

Example:"CRM-0001"

sectorstring, [ 0 .. 120 ] characters

Business sector

Default:""

Example:"Manufacturing"

sourcestring, [ 0 .. 80 ] characters

Lead source or origin

Default:""

Example:"Website"

addressstring, [ 0 .. 255 ] characters

Street address

Default:""

Example:"123 Main Street"

postalCodestring, [ 0 .. 20 ] characters

Postal code

Default:""

Example:"28001"

citystring, [ 0 .. 120 ] characters

City name

Default:""

Example:"Madrid"

stateIdinteger, (int32)

State/province identifier

Default:""

Example:28

countryIdinteger, (int32)required

Country identifier

Default:""

Example:1

mainPhonestring, [ 0 .. 40 ] characters

Primary phone number

Default:""

Example:"+34912345678"

additionalPhonestring, [ 0 .. 40 ] characters

Additional phone number

Default:""

Example:"+34912345679"

emailstring, (email), [ 0 .. 180 ] characters

Email address

Default:""

Example:"info@acme.com"

websitestring, [ 0 .. 255 ] characters

Website URL

Default:""

Example:"https://www.acme.com"

notesstring

Additional notes about the account

Default:""

employeeCountstring, [ 0 .. 20 ] characters

Number of employees range

Default:""

Example:"11-50"

tagsArray of strings

Tags associated with the account

Default:""

Example:

[
  "VIP",
  "Enterprise"
]

usersCompany1integer, (int32)

Primary assigned user identifier

Default:""

Example:1

usersCompany2integer, (int32)

Secondary assigned user identifier

Default:""

Example:2

usersCompany3integer, (int32)

Tertiary assigned user identifier

Default:""

Example:3

confirmDuplicateCifboolean

Confirm creation despite duplicate tax ID

Default:false

Example:false

POST

/api/v1/crm/account

curl -i -X POST \
  https://api.prana.software/api/v1/crm/account \
  -H 'Content-Type: application/json'

Responses

Bodyapplication/json

idinteger, (int32)required

Unique identifier of the object

Default:""

namestring

Account name

Default:""

Example:"ACME Corp"

legalNamestring

Legal registered name

Default:""

Example:"ACME Corporation S.L."

cifstring

Tax identification number

Default:""

Example:"B12345678"

codestring

Account code

Default:""

Example:"CRM-0001"

sectorstring

Business sector

Default:""

Example:"Manufacturing"

sourcestring

Lead source or origin

Default:""

Example:"Website"

typestring(ApiCrmAccountTypeEnum)

Account type: LEAD or CUSTOMER

Default:""

Enum:"LEAD""CUSTOMER"

Example:"LEAD"

customerobject(ApiCustomerListReadDto)

Linked customer when type is CUSTOMER

Default:""

addressstring

Street address

Default:""

Example:"123 Main Street"

postalCodestring

Postal code

Default:""

Example:"28001"

citystring

City name

Default:""

Example:"Madrid"

stateobject(ApiStateListReadDto)

State/province information

Default:""

countryobject(ApiCountryListReadDto)

Country information

Default:""

mainPhonestring

Primary phone number

Default:""

Example:"+34912345678"

additionalPhonestring

Additional phone number

Default:""

Example:"+34912345679"

emailstring

Email address

Default:""

Example:"info@acme.com"

websitestring

Website URL

Default:""

Example:"https://www.acme.com"

notesstring

Additional notes about the account

Default:""

employeeCountstring

Number of employees range

Default:""

Example:"11-50"

tagsArray of strings

Tags associated with the account

Default:""

Example:

[
  "VIP",
  "Enterprise"
]

usersCompany1object(ApiUsersCompanyListReadDto)

Primary assigned user

Default:""

usersCompany2object(ApiUsersCompanyListReadDto)

Secondary assigned user

Default:""

usersCompany3object(ApiUsersCompanyListReadDto)

Tertiary assigned user

Default:""

activeOpportunitiesCountinteger, (int32)

Number of active opportunities for this account

Default:""

Example:3

pipelineAmountnumber

Total pipeline amount from active opportunities

Default:""

Example:150000

lastActivityAtstring, (date-time)

Date and time of the last activity

Default:""

Example:"2026-05-01T10:30:00Z"

createdBystring

User who created the account

Default:""

Example:"user-uuid"

createdAtstring, (date-time)

Account creation timestamp

Default:""

Example:"2026-01-15T09:00:00Z"

updatedAtstring, (date-time)

Last update timestamp

Default:""

Example:"2026-05-01T10:30:00Z"

convertedAtstring, (date-time)

Timestamp when the lead was converted to customer

Default:""

Example:"2026-03-01T14:00:00Z"

Response

// No response example