News & Announcements User Community Developer Community

Welcome to the RingCentral Community

Please note the community is currently under maintenance and is read-only.

Make sure to review our Terms of Use and Community Guidelines.
  Please note the community is currently under maintenance and is read-only.
Home » Developers
Can you add a contact name / number to an organization via the API?
Tags: sdk
Jul 5, 2016 at 4:21am   •   4 replies  •  0 likes

Is it possible to add a new contact (a name and number for example) via the API so when a customer signs up there info is automatically added to RingCentral so if and when they call we have their name to show on the screen?

4 Answers
answered on Jun 25, 2019 at 8:31am  

The Address Book API has been released. You can use the createContact endpoint to create contacts within your organization. Here is a sample request and response for adding a contact that is available to everyone in your organization:

Sample Request

POST /restapi/v1.0/account/~/extension/~/address-book/contact

  "firstName": "Charlie",
  "lastName": "Williams",
  "businessPhone": "+15551234567",
  "businessAddress": {
    "street": "20 Davis Dr.",
    "city": "Belmont",
    "state": "CA",
    "zip": 94002

Sample Response


  "uri": "",
  "availability": "Alive",
  "id": 623045004,
  "firstName": "Charlie",
  "lastName": "Williams",
  "businessAddress": {
    "street": "20 Davis Dr.",
    "city": "Belmont",
    "state": "CA",
    "zip": 94002
  "businessPhone": "+15551234567"

answered on Apr 25, 2018 at 9:25am  
Is this released yet?

answered on Sep 7, 2017 at 8:47am  
Is this address book api released? Is there documentation for it?



answered on Jul 6, 2016 at 9:51am  
We do have an address book API in beta which would support this functionality. If you are interested in joining this beta, please submit a Developer Support Case. Please provide a clear and detailed use-case (how you plan on using this API resource, estimated number of requests hourly, and the data you expect to have available or be able to save) for requesting access to this API resource, the name of your application, and the APP ID.

Our engineering team will review this request for viability and if approved, enable this for your specific application.


A new Community is coming to RingCentral!

Posts are currently read-only as we transition into our new platform.

We thank you for your patience
during this downtime.

Try Workflow Builder

Did you know you can easily automate tasks like responding to SMS, team messages, and more? Plus it's included with RingCentral Video and RingEX plans!

Try RingCentral Workflow Builder

Developer Platform
Integrated Apps
App Gallery
Developer support
Games and rewards

Resource center
Product Releases
App Download
RingCentral App login
Admin Portal Login
Contact Sales
© 1999-2024 RingCentral, Inc. All rights reserved. Legal Privacy Notice Site Map Contact Us