Latest Legacy

Create a profile

This API lets you create a business profile for your end customers.

API Endpoint

POST https://api.plivo.com/v1/Account/{auth_id}/Profile/

Arguments

profile_aliasstringrequired

A friendly name for your profile.

customer_typestringrequired

Indicates the nature of your operations.

Allowed values: DIRECT, RESELLER.

Select RESELLER if your business provides communication services such as messaging and voice calling to other businesses.

entity_typestringrequired

Indicates ownership of the company.

Allowed values: PRIVATE, PUBLIC, NON_PROFIT, GOVERNMENT, INDIVIDUAL.

company_namestringrequired

Legal name of the company.

vertical stringrequired

Indicates industry.

Allowed values: PROFESSIONAL, REAL_ESTATE, HEALTHCARE, HUMAN_RESOURCES, ENERGY,ENTERTAINMENT, RETAIL, TRANSPORTATION,AGRICULTURE,INSURANCE,POSTAL,EDUCATION,HOSPITALITY, FINANCIAL, POLITICAL, GAMBLING, LEGAL, CONSTRUCTION, NGO, MANUFACTURING, GOVERNMENT, TECHNOLOGY, COMMUNICATION

ein integer

Employer Identification Number.

Plivo strongly recommends providing your EIN if your company is registered to unlock premium features like high throughput for Plivo products.

ein_issuing_countrystring

The ISO country code of the country that issued the EIN.

address objectrequired

Valid postal address of the company.

{
"street": "",
"city": "",
"state": "",
"postal_code": "",
"country": ""

}

state: A valid state code, e.g. TX for Texas.
postal_code: ZIP code.
country: ISO alpha-2 country code (US).

authorized_contact objectrequired

Authorized contact person at the company.

"first_name": "John",
"last_name": "Doe",
"email": "john@example.com",
"title": "Mr",
"seniority": "admin",
"phone": ""

Fields first_name and last_name are free-form.

email: Email address.
title: Salutation of the contact at the given company.
seniority: Allowed values: DIRECTOR, GM, VP, CEO, CFO, GENERAL_COUNSEL, OTHER.
phone: Company phone number in E.164 format.
stock_symbol string

Stock symbol of the company.

stock_exchange enum

Stock exchange where your company is listed.

Allowed values: NASDAQ, NYSE, AMEX, AMX, ASX, B3, BME, BSE, FRA, ICEX ,JPX, JSE, KRX ,LON, NSE, OMX, SEHK, SGX, SSE, STO, SWX, SZSE, TSX ,TWSE, VSE, OTHER

alt_business_id string

Alternate business identification number.

alt_business_id_type enum

Alternate business ID type.

Allowed values: DUNS, LEI, GIIN, NONE

website string

Website of the business.

plivo_subaccount string

Subaccount mapped to the profile.

Create a profile — individuals

If you use the Create a Profile API and specify entity_type=INDIVIDUAL you can skip fields like ein, ein_issuing_country, stock_symbol, stock_exchange, alt_business_id, and alt_business_id_type.

Returns

api_id for the request, unique profile_uuid, and success message

Response

HTTP Status Code: 200

{
    "api_id": "4e1f954c-baf3-11ec-bafe-0242ac110003",
    "message": "Profile created successfully.",
    "profile_uuid": "f19c4773-4ae6-4b75-92ea-9cf3ea4227d6"
}

Example Request

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
import plivo

client = plivo.RestClient("<auth_id>", "<auth_token>")
response = client.profile.create(
    profile_alias="profile name sample",
    customer_type="DIRECT",
    entity_type="PRIVATE",
    company_name="ABC Inc.",
    ein="123456789",
    ein_issuing_country="US",
    stock_symbol="ABC",
    stock_exchange="NSE",
    website="www.example.com",
    vertical="REAL_ESTATE",
    alt_business_id="",
    alt_business_id_type="NONE",
    plivo_subaccount="",
    address={
        "street": "123",
        "city": "New York",
        "state": "NY",
        "postal_code": "10001",
        "country": "US",
    },
    authorized_contact={
        "first_name": "john",
        "last_name": "con",
        "phone": "1876865565",
        "email": "xyz@plivo.com",
        "title": "Mr",
        "seniority": "admin",
    },
)
print(response)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
require "rubygems"
require "/etc/plivo-ruby/lib/plivo.rb"
include Plivo

api = RestClient.new("<auth_id>", "<auth_token>")

begin
	# Create Profile
	puts('Create Profile')

	authorized_contact_data = {
		"first_name" => "<First Name>",
		"last_name" => "<Last Name>",
		"email" => "<Email ID>",
		"title" => "Mr.",
		"seniority" => "admin",
		"phone" => "919539113734",
	}

	address_data = {
		"street" => "Street Name",
		"city" => "City Name",
		"state" => "NY",
		"postal_code" => "10001",
		"country" => "US"
	}

	response = api.profile.create(  profile_alias: "<Profile Name>", 
		customer_type: "DIRECT",
		entity_type: "PRIVATE",
		company_name: "<Legal Company Name>",
		vertical: "ENERGY",
		stock_symbol: "NSE",
		stock_exchange: "NASDAQ",
		alt_business_id: "NONE",
		alt_business_id_type: "NONE",
		ein: "123456789",
		ein_issuing_country: "IN",
		website: "<Company Website>",
		address: address_data,
		authorized_contact: authorized_contact_data
	)

	puts response
rescue PlivoRESTError => e
	puts 'Exception: ' + e.message
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
let plivo = require('plivo');

var authorized_contact = {
    "first_name": "John",
    "last_name": "Doe",
    "email": "john@example.com",
    "title": "manager",
    "seniority": "admin",
    "phone": "+12125551234"
}
var address = {
    "street": "660 Broadway",
    "city": "New York City",
    "state": "NY",
    "postal_code": "10001",
    "country": "US"
}
var client = new plivo.Client("<auth_id>", "<auth_token>");
client.profile.create(
    "my_profile", // profile_alias
    "SA2025RK4E639VJFZAMS", // plivo_subaccount 
    "DIRECT", // customer_type
    "GOVERNMENT", // entity_type
    "ABC Inc", // compnay_name
    "111111111", // ein
    "PROFESSIONAL", // vertical
    "US", // ein_issuing_country
    "ABC", // stock_symbol
    "NASDAQ", // stock exchange
    "NONE", // alt_business_id_type
    "google.com", // website
    address,
    authorized_contact)
    .then(function (response) {
        console.log(response);
    })
    .catch(function (error) {
        console.log(error);
    });
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
<?php

# Available in versions >= 4.29.0 (https://github.com/plivo/plivo-php/releases/tag/v4.29.0)

require '/etc/plivo-php/vendor/autoload.php';
use Plivo\RestClient;

$client = new RestClient("<auth_id>", "<auth_token>");

$client
    ->client
    ->setTimeout(60);
try
{
    $authorized_contact = array(
        "first_name" => "John",
        "last_name" => "Doe",
        "email" => "john@example.com",
        "title" => "manager",
        "seniority" => "admin"
    );
    $address = array(
        "street" => "660 Broadway",
        "city" => "New York City",
        "state" => "NY",
        "postal_code" => "10001",
        "country" => "US"
    );
    $res = $client
        ->profile
        ->create("vishnu104", "", "DIRECT", "GOVERNMENT", "ABC Inc", "111111111", "PROFESSIONAL", "US", "ABC", "NASDAQ", "NONE", "google.com", $address, $authorized_contact);
    print_r($res);
}
catch(PlivoRestException $ex)
{
    print_r($ex);
}

?>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
package com.plivo.examples;

import com.plivo.api.Plivo;
import com.plivo.api.models.profile.Profile;
import com.plivo.api.models.profile.ProfileAddResponse;
import com.plivo.api.models.profile.ProfileAddress;
import com.plivo.api.models.profile.ProfileAuthorizedContact;

public class PlivoTest {

    public static void main(String[] args) {

        Plivo.init("<auth_id>", "<auth_token>");

        // Create Profile

        ProfileAddress address = new ProfileAddress("street name", "New York", "NY", "123456", "US");
        ProfileAuthorizedContact authorizedContact = new ProfileAuthorizedContact("firstname",
            "lastname",
            "12017135399",
            "test@plivo.com",
            "Mr.",
            "admin");

        try {
            ProfileAddResponse response = Profile.creator("", "DIRECT", "PRIVATE", "Plivo Inc",
                "12345678", "IN", address, "ABC",
                "NSE", "www.javasdk.com",
                "ENERGY", "", "", "",
                authorizedContact).create();
            System.out.println(response);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
// Available in versions >= 5.9.0 (https://github.com/plivo/plivo-dotnet/releases/tag/v5.9.0)

using System;
using System.Collections.Generic;
using Plivo;
using Plivo.Exception;
using Plivo.Resource.Profile;

namespace dotnet_project
{
    class Ten_dlc
    {
        static void Main(string[] args)
        {

            var api = new PlivoApi("<auth_id>", "<auth_token>");

            // Create a Profile
            try
            {
                AuthorizedContact contact = new AuthorizedContact();
                contact.Email = "john@example.com";
                contact.Phone = "12025551234";
                contact.FirstName = "John";
                contact.LastName = "Doe";
                contact.Seniority = "none";
                contact.Title = "Mr";
                Address address = new Address();
                address.Street = "660 Broadway";
                address.City = "New York";
                address.PostalCode = "10001";
                address.Country = "US";
                var response = api.Profile.Create("john_profile_1", "", "RESELLER", "PUBLIC", "Company Name Inc",
                "111111111", "PROFESSIONAL", "US", "ABC", "NASDAQ", "www.webistename.com", "NONE", contact, address);
                Console.WriteLine(response);
            }
            catch (PlivoRestException e)
            {
                Console.WriteLine("Exception: " + e.Message);
            }

        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
curl -i --user auth_id:auth_token \
    -H 'Content-Type: application/json' \
    -d '{
        "profile_alias": "john_new",
        "customer_type": "reseller",
        "entity_type": "public",
        "company_name": "ABC Inc.",
        "vertical": "Entertainment",
        "plivo_subaccount" :"SA2025RK4E639VJFZAMM",
        "ein": "122321231",
        "ein_issuing_country":"US", 
        "address": {
            "street": "660 Broadway",
            "city": "New York City",
            "state": "NY",
            "postal_code": "10001",
            "country": "US"
        },
        "stock_symbol": "TESLA",
        "stock_exchange": "NYSE",
        "alt_business_id_type": "DUNS",
        "alt_business_id": "ABC",
        "website": "hibye.com",
        "authorized_contact": {
            "first_name": "John",
            "last_name": "Doe",
            "email": "john@example.com",
            "title": "manager",
            "seniority": "admin",
            "phone": "12125551234"
        }
    
    }' \
    https://api.plivo.com/v1/Account/{auth_id}/Profile/
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
package main

import (
	"fmt"
	"os"

	plivo "github.com/plivo/plivo-go/v7"
)

var client *plivo.Client

func initClient(authID, authToken string) {
	var er error
	copts := &plivo.ClientOptions{}
	client, er = plivo.NewClient(authID, authToken, copts)
	if er != nil {
		panic(er)
	}
}
func main() {
	initClient("<auth_id>", "<auth_token>")
	//Profile create
	input := plivo.CreateProfileRequestParams{
		ProfileAlias:         "<Profile_Name>",
		customer_type:        "DIRECT",
		entity_type:          "PRIVATE",
		company_name:         "<Legal Company Name>",
		vertical:             "ENERGY",
		stock_symbol:         "NSE",
		stock_exchange:       "NASDAQ",
		alt_business_id:      "NONE",
		alt_business_id_type: "NONE",
		ein:                  "123456789",
		ein_issuing_country:  "IN",
		website:              "<Company Website>",
		address:              "address_data",
		authorized_contact:   "authorized_contact_data",
		Address: &plivo.Address{
			"street":      "Street Name",
			"city":        "City Name",
			"state":       "NY",
			"postal_code": "10001",
			"country":     "US",
		},
		AuthorizedContact: &plivo.AuthorizedContact{
			"first_name": "<First Name>",
			"last_name":  "<Last Name>",
			"email":      "<Email ID>",
			"title":      "Mr.",
			"seniority":  "admin",
			"phone":      "<phone_ number>",
		},
	}
	response, err := client.Profile.Create(input)
	if err != nil {
		fmt.Printf("Error occurred while creating profile. error:%+v\n", err)
		os.Exit(1)
	} else {
		fmt.Printf("%+v\n", response)
	}
}